home *** CD-ROM | disk | FTP | other *** search
/ LSD Docs / LSD Docs.iso / FILEZ / lsd20.dms / lsd20.adf / DiskMaster2.doc.pp / DiskMaster2.doc
Text File  |  1995-04-14  |  136KB  |  3,731 lines

  1.  
  2.                              DISKMASTER II
  3.  
  4.                     The Ultimate Disk Utility System
  5.  
  6. TABLE OF CONTENTS
  7.  
  8. 1.   Introduction 1
  9.      1.1. What is DiskMaster? 1
  10.      1.2. System Requirements 1
  11.      1.3. System Extras 1
  12.      1.4. Input Devices 2
  13.      1.5. The Amiga Mouse 2
  14.      1.6. Other Input Devices 4
  15.      1.7. Coping the DiskMaster Program to Your Hard Drive 4
  16.      1.8. Making a Working Copy of DiskMaster 4
  17.  
  18. 2.   The Default DiskMaster 6
  19.      2.1. DiskMaster Screen Elements 7
  20.      2.2. Using DiskMaster 9
  21.           2.2.1.  The Amiga Directory Structure 10
  22.           2.2.2.  Exploring the Directory Structure 11
  23.           2.2.3.  DiskMaster's Default Commands 13
  24.           2.2.4.  DiskMaster's Default AutoCommands 18
  25.           2.2.5.  DiskMaster's Default Menus 19
  26.                2.2.5.1.  Project Menu 19
  27.                2.2.5.2.  Tools Menu 21
  28.                2.2.5.3.  Archive Menu 22
  29.                2.2.5.4.  Disk Menu 24
  30.                2.2.5.5.  Control Menu 26
  31.  
  32. 3.   The Custom DiskMaster 28
  33.      3.1. Configuration (script) Files 28
  34.      3.2. Adding Commands 30
  35.      3.3. Adding Menu Commands 33
  36.      3.4. Custom Information Display 35
  37.           3.4.1.  Display Format 35
  38.           3.4.2.  Display Font 37
  39.      3.5. Exploring the Configuration File 38
  40.      3.6. Editing the Configuration File 39
  41.      3.7. Multiple Command Windows 41
  42.           3.7.1  Replacing Menus with Command Windows 42
  43.  
  44. 4.   DiskMaster Requesters and Screens 45
  45.      4.1. Confirmation Requester 45
  46.      4.2. String Requester 46
  47.      4.3. Palette Requester 47
  48.      4.4. File Reader 48
  49.      4.5. Printer Setup Requester 51
  50.      4.6. Disk Format Requester 54
  51.      4.7. DiskCopy Requester 56
  52.  
  53. 5.   DiskMaster/ARexx Commands 57
  54.  
  55. 6.   INDEX 93
  56.  
  57.                                (Page 1)
  58.  
  59. 1.   INTRODUCTION
  60.  
  61. 1.1. What is DiskMaster?
  62.  
  63.      DiskMaster is a disk utility program which combines the most used
  64.      disk commands in an easy to use point and click mouse
  65.      environment.  DiskMaster can also make use of external programs
  66.      such as archive programs, text editors, file editors, ILBM or
  67.      animation viewing programs, etc., making them easier to use.
  68.  
  69.      DiskMaster 2.0 has the ability to communicate with other programs
  70.      using its ARexx port, and execute complex ARexx scripts which can
  71.      automate multi-step disk operations.
  72.  
  73. 1.2. System Requirements
  74.  
  75.      DiskMaster will run on any Amiga 500, 1000, 2000 series or 3000
  76.      series computer running under Kickstart 1.2 or higher, including
  77.      AmigaDOS 2.0.
  78.  
  79. 1.3. System Extras
  80.  
  81.      To make full use of DiskMaster's ability to use external
  82.      programs, you must obtain the following programs:
  83.  
  84.      Archive Programs - The public domain programs ARC, LHARC, and
  85.      Amiga ZOO will be necessary to make use of the file archive
  86.      commands.
  87.  
  88.      ARexx - Although DiskMaster can execute scripts using its own set
  89.      of built in commands, including DiskMaster's commands in an ARexx
  90.      script can result in much more
  91.  
  92.                                (Page 2)
  93.  
  94.      powerful commands.  ARexx allows DiskMaster to communicate with
  95.      other ARexx compatible programs through ARexx scripts.
  96.  
  97.      ScreenShare - The ScreenShare library allows you to open windows
  98.      and requesters in a screen belonging to another program.
  99.  
  100.      Text Editor - While DiskMaster contains its own powerful text
  101.      reader, it has no built-in facilities to edit text files.  We
  102.      recommend that you have available, a text editor that you find
  103.      comfortable to use.  We also recommend that your text editor have
  104.      "Cut", "Copy", and "Paste" operations.
  105.  
  106. 1.4. Input Devices
  107.  
  108.      In addition to the keyboard, the computer's standard input
  109.      device, the Amiga has an alternate input device - the mouse.  The
  110.      mouse has proven useful for graphic applications such as painting
  111.      and drawing.  It also provides an easy-to-use method of issuing
  112.      commands to the computer.  DiskMaster was designed to make full
  113.      use of the Amiga's mouse-driven interface.
  114.  
  115. 1.5. The Amiga Mouse
  116.  
  117.      Pictured below is a standard Amiga style mouse.  DiskMaster's
  118.      mouse pointer is controlled by the movement of the mouse across a
  119.      table or mouse pad.
  120.  
  121.      The Amiga mouse has two buttons.  The Select Button (the left
  122.      mouse button) is used to select an icon or screen position.
  123.      Pressing on the Select Button will select the icon, gadget, or
  124.      drag bar that is presently under the mouse pointer.
  125.  
  126.                                (Page 3)
  127.  
  128.      The Menu Button (the right mouse button) is normally used to
  129.      display the available Pull-Down Menus at the top of the screen.
  130.      Move the mouse pointer over the information bar and
  131.      press-and-hold the Menu Button.  If the pointer is positioned
  132.      directly over a menu header, the menu will appear.  While holding
  133.      down the Menu Button, move the pointer over each of the menu
  134.      headers to view each menu.  Still holding down the Menu Button,
  135.      move the mouse down one of the menus.  As the pointer moves down
  136.      the menu, menu items will become highlighted.
  137.  
  138.      Note:  This manual will represent a particular menu item by
  139.      listing the path taken to reach the menu item.  The path will be
  140.      in bold face, and each path level will be separated with a slash
  141.      mark (\).  For instance, MenuHeader\MenuItem.
  142.  
  143.                         (Page 4)
  144.  
  145. 1.6. Other Input Devices
  146.  
  147.      Several Alternate input devices are available for the Amiga,
  148.      including Light Pens, Digitizing Tablets, Track Balls, etc.
  149.      DiskMaster will work with any of these alternate input devices as
  150.      long as they completely emulate the standard Amiga mouse.  They
  151.      must have a Select Button, and a Menu Button, in addition to a
  152.      method of positioning the pointer on the screen.
  153.  
  154. 1.7. Copying the DiskMaster Program to Your Hard Drive
  155.  
  156.      We recommend that you copy the DiskMaster to your hard drive and
  157.      place the original distribution disk in a safe place to be used
  158.      as a "backup".  Simply open the DiskMaster distribution disk by
  159.      double-clicking on its icon.  When the DiskMaster window opens,
  160.      click on and drag the DiskMaster icon to the desired window on
  161.      your hard drive.  No other files must be present in order for
  162.      DiskMaster to run.  However, you may want to move some of the
  163.      example project files over to your hard drive as well.  These are
  164.      copied in the same manner as DiskMaster.
  165.  
  166. 1.8. Making a Working Copy of DiskMaster
  167.  
  168.      Before extensively using your original DiskMaster distribution
  169.      disk, we recommend that you make a working copy to be used on a
  170.      daily basis, and place the original disk in a safe place to be
  171.      used as a "backup".
  172.  
  173.      DiskMaster can make this copy for you.  Load DiskMaster by
  174.      double-clicking on its icon.  After DiskMaster loads
  175.  
  176.                                (Page 5)
  177.  
  178.      and the credits window closes, select the Disk\Copy DF0:DF0:menu
  179.      command.  Insert the DiskMaster distribution disk into DF0: (make
  180.      sure the disk is write protected or the disk copy will not
  181.      proceed).  When prompted (messages are displayed in the
  182.      DiskMaster title bar), remove the DiskMaster distribution disk,
  183.      and insert a blank floppy disk into DF0:.  When all feedback and
  184.      drive activity stops, remove your working copy of DiskMaster.
  185.  
  186.      If your system has a second floppy drive designated "DF1:", you
  187.      may use the Disk\Copy DF0: DF1: menu command to avoid the need to
  188.      swap disk.
  189.  
  190.      Note:  If you have an Amiga 500 or 1000, "DF0:" is the internal
  191.      floppy drive, while "DF1:" is the external floppy drive.  If you
  192.      have an Amiga 2000 or 3000 series computer, both "DF0:" and
  193.      "DF1:" are internal floppy drives.  If your Amiga 2000 or 3000
  194.      series computer does not have a second internal floppy drive, but
  195.      does have an external floppy drive, the name of the first
  196.      external floppy drive is "DF2:".
  197.  
  198.                                (Page 6)
  199.  
  200. 2.   The Default DiskMaster
  201.  
  202.      DiskMaster 2.0 is a completely new version of the original
  203.      DiskMaster program.  However a "default mode" is provided which
  204.      is similar in look and feel to the original.  Later in the manual
  205.      we will explore the many ways in which DiskMaster can be
  206.      customized.
  207.  
  208.      Start DiskMaster by double-clicking on its icon.  A custom four
  209.      color screen will open and three windows will open on the custom
  210.      screen.  Notice that the four colors used by DiskMaster are the
  211.      first four colors of your Workbench screen.  A "credits" window
  212.      will appear displaying information about DiskMaster.  Click
  213.      anywhere on the credits window to close it.  This "credits"
  214.      window appears automatically only if DiskMaster is running in its
  215.      default mode.  Once a configuration file has been saved, this
  216.      window will be opened only on command.
  217.  
  218.                             (Page 7)
  219.  
  220. 2.1. DiskMaster Screen Elements
  221.  
  222.      There are four main elements of the DiskMaster screen.
  223.      They are:
  224.  
  225.      Title Bar - The title bar is used as a feedback window.  When no
  226.      operation is taking place, it displays the program name, the
  227.      current time and date, and information about ram availability.
  228.  
  229.      However, when an operation is taking place, information about
  230.      that operation is displayed in this area.  For instance, when
  231.      copying files, the name of the file currently being copied will
  232.      be displayed.
  233.  
  234.      File Display Windows - These are resizable windows which display
  235.      information about the files in the current directory such as file
  236.      name, file size, time and date the file was last changed,
  237.      protection bits, and file comment.  Each file display window can
  238.      be in one of three states: Source (indicated by an "S" just below
  239.      the depth gadget), Destination (indicated by a "D" just below the
  240.      depth gadget), and Neutral (indicated by displaying nothing just
  241.      below the depth gadget).  By default, clicking into any window
  242.      will cause it to become the source window, changing the previous
  243.      source window
  244.  
  245.                                (Page 8)
  246.  
  247.      into the destination window.  If only two file display windows
  248.      are open, there will always be a source window and a destination
  249.      window.
  250.  
  251.      If the list files exceeds the windows ability to display them,
  252.      the proportional slider gadget at the right side of the window
  253.      will indicate the amount of the total list that is currently
  254.      displayed in the window.  Currently hidden files can be displayed
  255.      by clicking on the scroll arrows below the proportional slider
  256.      gadget.  Alternatively, moving the slider gadget up or down by
  257.      clicking above or below it, or by clicking on and dragging it up
  258.      or down.
  259.  
  260.      Command Windows - These are resizable windows which contain a
  261.      list of commands that will be executed upon their activation.  By
  262.      default, there is only one command window which is located
  263.      between two file display windows.  The commands in the window
  264.      affect the source window of files selected in the source window.
  265.      Like the file display windows, the command windows also have
  266.      proportional slider gadget and scroll arrows to display commands
  267.      that cannot be displayed in the command window.
  268.  
  269.      Pull-Down Menus - The default set of menus contain commands that
  270.      may always be appropriate to be displayed in the command window.
  271.      For instance, they may start an operation that does not affect
  272.      any
  273.  
  274.                                (Page 9)
  275.  
  276.      file, or either of the file display windows.  Their placement in
  277.      the menus rather than in the command window is purely
  278.      organizational.
  279.  
  280. 2.2. Using DiskMaster
  281.  
  282.      By default, DiskMaster will open with two file display windows
  283.      and a single command window.
  284.  
  285.      One file display window is the source window while the other is
  286.      the destination window.  Commands are issued by first selecting
  287.      (highlighting) one or more files, or one or more directories that
  288.      will be affected by the desired command.  When the files or
  289.      directories have been selected, clicking on the desired command
  290.      in the command window will perform the corresponding operation.
  291.      However, before you can select a file, you must be able to find
  292.      it in one of the file display windows.  The following section
  293.      describes the directory structure and how to view directories and
  294.      their files.
  295.  
  296.                                (Page 10)
  297.  
  298. 2.2.1. The Amiga Directory Structure
  299.  
  300.      The directory structure uses a system of directories and
  301.      sub-directories to organize the storage of files in a hierarchial
  302.      manner.  The Root directory is the first level of the directory
  303.      structure.  It can contain files and sub-directories.  Each
  304.      sub-directory of the root can also contain files and additional
  305.      sub-directories.  By allowing directories to contain additional
  306.      directories, the task of finding a particular file can be made
  307.      much easier.  For instance, if you are looking for a drawing that
  308.      was created with the IntroCAD package, looking at the directory
  309.      names can give you an idea where to look.  The illustration
  310.      below demonstrates how the storage of the file may be organized.
  311.      
  312.                Root Directory
  313.              -----------------
  314.              |              |
  315.       Word Processing    Graphics
  316.                              |
  317.                     ---------------------
  318.                     |                   |
  319.                   Paint                CAD
  320.                                         |
  321.                                -------------------
  322.                                |                 |
  323.                            UltraDesign       IntroCAD Plus
  324.                                                  |
  325.                                          ------------------
  326.                                          |                |
  327.                                      Postscript        Drawings
  328.  
  329.      From the root directory, the file is more likely to be stored in
  330.      "Graphics" than in "Word Processing".  From the "Graphics"
  331.      directory, the file is more apt to be stored in "CAD" than in
  332.      "Paint.  From the "CAD" directory, the file is more apt to be
  333.      stored in "IntroCAD Plus" than in "UltraDesign".  From the
  334.      "IntroCAD Plus" directory, the file is more apt to be stored in
  335.      "Drawings" than in "Postscript".
  336.  
  337.                                (Page 11)
  338.  
  339.      As you can see, every time you enter a new level of the directory
  340.      structure, you are presented with a new set of options.  If the
  341.      file you are looking for does not exist in the current directory,
  342.      it may exist in a "deeper" directory.  Using the names of the
  343.      directories as a guide, you should be able to find any file.
  344.  
  345.      As demonstrated in the example above, the use of a hierarchial
  346.      file system can be used to great benefit in the organization of
  347.      your files.  However, it can also be misused to the point of not
  348.      being able to find any file.  If this is the case don't worry,
  349.      DiskMaster can help you find your files and re-organize your
  350.      files.
  351.  
  352. 2.2.2. Exploring the Directory Structure
  353.  
  354.      By default, when DiskMaster first loads both file display windows
  355.      contain a list of physical and logical storage devices.  From
  356.      here you can select your initial "root directory".
  357.  
  358.      The type of device is specified for each entry, enclosed in
  359.      parentheses.  The device types are as follows:
  360.  
  361.      (DEV) - Indicates that the entry is the device name of a physical
  362.      storage device.
  363.  
  364.      (VOL) - Indicates that the entry is the volume name of a physical
  365.      storage device.
  366.  
  367.                                (Page 12)
  368.  
  369.      (ASN) - Indicates that the entry is the name of an assignment
  370.      made to a storage device, or a sub-directory of a storage device.
  371.  
  372.      Double-clicking on one of these entries will read the root
  373.      directory of that device or assignment.  Once the root directory
  374.      has been read, files and sub-directories contained within that
  375.      directory will be displayed in the file display window.
  376.  
  377.      Note:  The colors used to display files and directories depend on
  378.      the palette used by your Workbench screen.  Since even the
  379.      default colors of Workbench 1.3 and 2.0 differ greatly, we will
  380.      refer to the colors used by their Workbench color register
  381.      number.
  382.  
  383.      Directories - Directories are displayed at the top of the file
  384.      display window.  They can be distinguished from files by the fact
  385.      that they show no file size, and they are displayed in a
  386.      different color.  By default, they will be displayed in Workbench
  387.      Color 3.  Single-clicking a directory will select (highlight) it,
  388.      while double-clicking a directory will read that directory and
  389.      display its contents.  Single-clicking on a selected directory
  390.      will deselect it.
  391.  
  392.      Files - Files are displayed below the directories in the file
  393.      display window.  They can be distinguished from directories by
  394.      the fact that the file size is displayed, and they are displayed
  395.      in a different color.  By default, they will be displayed in
  396.      Workbench Color 1.  Single-clicking a file will select
  397.      (highlight) it.  Single-clicking on a selected file will deselect
  398.      it.
  399.  
  400.      Note:  Double-clicking a file will invoke an "AutoCommand".  This
  401.      new feature of DiskMaster will be discussed in Section 2.2.4. of
  402.      this manual.
  403.  
  404.                                (Page 13)
  405.  
  406.      By double-clicking on directories, you can read the contents of a
  407.      directory, or "enter" a directory.  To return to the directory
  408.      level above the current directory, click on the Parent command in
  409.      the command window.  Alternately, "S" (source) and "D"
  410.      (destination) indicators will act as "parent" buttons.  Clicking
  411.      on these indicators will also return you to the parent directory.
  412.      Clicking on the Root command in the command window will return
  413.      you to the root directory of the current path.
  414.  
  415. 2.2.3. DiskMaster Default Commands
  416.  
  417.      Root - Clicking on this command will cause the source window to
  418.      display the root directory of its current path.  No file or
  419.      directory selection is required.
  420.  
  421.      Parent - Clicking on this command will cause the source window to
  422.      display the contents of the parent directory in the current path.
  423.      No file or directory selection is required.
  424.  
  425.      All - Clicking on this command will select (highlight) all files
  426.      and directories in the source window.
  427.  
  428.      Clear - Clicking on this command will deselect all files and
  429.      directories in the source window.
  430.  
  431.      Select - This command allows you to select multiple files in the
  432.      source window based on the pattern of their names.  Clicking on
  433.      this command will open a small requester asking for the pattern
  434.      to be used for file selection (see illustration on next page).
  435.      The requester accepts the wild card characters "?" (single
  436.      unknown character) and "*" (one or more unknown characters).
  437.  
  438.                                (Page 14)
  439.  
  440.      Exclude - This command allows you to deselect multiple files in
  441.      the source window based on the pattern of their names.  Clicking
  442.      on this command will open a small requester asking for the
  443.      pattern to be used for file selection (see illustration above).
  444.      The requester accepts the wild card characters "?" (single
  445.      unknown character) and "*" (one or more unknown characters).
  446.  
  447.      Copy - Clicking on this command will copy any selected files or
  448.      directories from the source window to the destination window.
  449.  
  450.      Copy Newer - Clicking on this command will copy and selected
  451.      files or files within selected directories from the source window
  452.      to the destination window.  ONLY IF THEIR FILE DATES INDICATE
  453.      THAT THEY ARE NEWER FILES THAN THE EXISTING FILES IN THE
  454.      DESTINATION WINDOW.
  455.  
  456.      Move - Clicking on this command will copy any selected files and
  457.      directories from the source window to the destination window,
  458.      then delete the copied files from the source window.
  459.  
  460.      Delete - Clicking on this command will open a confirmation
  461.      requester warning that all files will be lost.  Clicking on
  462.      Continue will delete and selected files and directories from the
  463.      source window.
  464.  
  465.                                (Page 15)
  466.  
  467.      Protect - Changes the current protection bits of selected files
  468.      or directories.  Each file has eight protection bits which may be
  469.      turned ON or OFF.  These protection bits either protect the file
  470.      from certain operations such as "delete", or indicate an
  471.      attribute of the file.  Each file in the file display window
  472.      displays the name of the bit if it is turned on, or displays a
  473.      "-" character if it is turned off.  The protection bits have the
  474.      following single character names and indicate the following when
  475.      they are turned ON:
  476.  
  477.      H - Indicates that the file should be Hidden.
  478.      S - Indicates that the file is an AmigaDOS Script.
  479.      P - Indicates that the file is Pure and can be made Resident.
  480.      A - Archive Bit; used by hard disk backup programs to indicate
  481.          whether or not the file has been backed up.  This bit is
  482.          automatically reset to OFF if any other tool has written to
  483.          the file.
  484.      R - Indicates that the file may be Read.
  485.      W - Indicates that the file may be Written to.
  486.      E - Indicates that the file may be Executed.
  487.      D - Indicates that the file may be Deleted.
  488.  
  489.      Clicking on this command will open a requester asking for a list
  490.      of bits to be turned ON or turned OFF.
  491.  
  492.      Bits which are to be turned ON follow a plus sign (+), while bits
  493.      which are to be turned OFF follow a minus sign (-).  The default
  494.      setting for this requester is "-HSPA+RWED" (no quotes).  This
  495.      default setting specifies that the H,S,P, and A bits are to be
  496.      turned off, and the R,W,E, and D bits are to be turned ON.  For
  497.      instance, if the
  498.  
  499.                                (Page 16)
  500.  
  501.      delete bit (D) were to be turned off, but the other bits were to
  502.      be left untouched, the protect requester string would be simply
  503.      "-D" (no quotes).  It is NOT necessary to specify the status of
  504.      all eight bits.
  505.  
  506.      Comment - Allows you to edit the comment of selected files.
  507.      Clicking on this command will open a requester displaying the
  508.      current comment (if any).
  509.  
  510.      After editing the comment and pressing (Return), the new comment
  511.      will be written to the file.
  512.  
  513.      Find - Searches for files matching a specified pattern within the
  514.      selected directories or devices.  Clicking on this command will
  515.      open a requester asking for the pattern to be matched.
  516.  
  517.      The requester accepts the wild card characters "?" (single
  518.      unknown character) and "*" (one or more unknown characters).
  519.      After the pattern has been specified, DiskMaster will search the
  520.      selected devices or directories for any file which matches that
  521.      pattern.  When a file is found, another requester will open,
  522.      informing you of the file that has been found, and asking if you
  523.      want to open a new window.  Clicking on OPEN will open a new
  524.      window displaying the directory in which the file was found.
  525.  
  526.                                (Page 17)
  527.  
  528.      Clicking on Continue will proceed with the search for more files
  529.      which match the specified pattern.  Clicking on Abort will stop
  530.      the search.
  531.  
  532.      Read - Clicking on this command will use DiskMaster's built-in
  533.      text reader to display in ASCII, the contents of selected files.
  534.      The file reader is quite powerful and has several options which
  535.      are described in Section 4.4. of this manual.
  536.  
  537.      HexRead - Clicking on this command will use DiskMaster's built-in
  538.      HEX reader to display in Hexadecimal and ASCII, the contents of
  539.      selected files.  The Hex reader allows the same options as the
  540.      file reader described in Section 4.4. of this manual.
  541.  
  542.      ShowPic - Clicking on this command will read and display any
  543.      selected IFF picture files, or play any selected 8SVX sound
  544.      files.
  545.  
  546.      Note:  DiskMaster will NOT display IFF24 format files.  Because
  547.      of the vast array of resolutions that can be stored within an
  548.      IFF24 file, we recommend that you use an image processing program
  549.      to interpret the file into a displayable format and save it as a
  550.      standard IFF format file.
  551.  
  552.      MakeDir - Clicking on this command will open a requester asking
  553.      for the name of the new directory to be created.
  554.  
  555.      DiskMaster will then create a new directory, using the specified
  556.      name, in the source directory.
  557.  
  558.                          (Page 18)
  559.  
  560.      Print - Clicking on this command will print the selected files,
  561.      according to their structure.  Text files will be printed as
  562.      ASCII, binary files (including program and sound files) will be
  563.      printed in HEX, and IFF picture files (not IFF24) will be printed
  564.      using the printer's graphic mode.
  565.  
  566.      Size Check - Clicking on this command will calculate the disk
  567.      space needed to copy the selected files and directories from the
  568.      source directory to the destination directory and inform you
  569.      whether there is enough space to do so.  If there IS enough room,
  570.      DiskMaster will also tell you how many bytes will be copied and
  571.      how much free space will be left in the destination directory.
  572.  
  573. 2.2.4. DiskMaster's Default AutoCommands
  574.  
  575.      A new feature of DiskMaster 2.0 is its ability to evaluate files
  576.      and perform predefined commands on them simply by double-clicking
  577.      on them.  For instance, double-clicking on an IFF ILBM (picture)
  578.      file will invoke the "Show-Pic" command to display the picture.
  579.      The AutoCommands that are part of DiskMaster's default
  580.      configuration are as follows:
  581.  
  582. Iff Files:
  583.   
  584.      ILBM, ACBM and 8SVX files will invoke DiskMaster's built-in
  585.      "ShowPic" command.  This command will show ILBM and ACBM
  586.      pictures, and play 8SVX sound files.
  587.  
  588.      ANIM files will invoke an external command called "View".  View
  589.      is a flexible program written, and released into the public
  590.      domain by Michael W. Hartman, author of Animation Station.
  591.  
  592.                                (Page 19)
  593.  
  594. Archived Files:
  595.  
  596.      Files recognized as ARC, ZOO or LHARC files will call the
  597.      appropriate archive program to decompress the file.  The
  598.      decompressed file(s) will be located in the same directory as the
  599.      original archive file.
  600.  
  601. Text Files:
  602.  
  603.      Files recognized as text will be read using DiskMaster's built in
  604.      file reader.
  605.  
  606. Other Files:
  607.  
  608.      Any file that cannot be identified as any of the above file
  609.      types, will be read using the file reader's hexadecimal option.
  610.  
  611. 2.2.5. DiskMaster's Default Menus
  612.  
  613.      By default, DiskMaster has five pull-down menus.  They are
  614.      Project, Tools, Archive, Disk, and Control.  Several commands
  615.      found in the menus are designed to customize the way DiskMaster
  616.      appears and operates.  These customizing commands identified by
  617.      the word "Custom", will be discussed in the Section 3., The
  618.      Custom DiskMaster.
  619.  
  620. 2.2.5.1. Project Menu
  621.  
  622.      Display Format - Custom
  623.  
  624.      Add Command - Custom
  625.  
  626.      Add Menu Item - Custom
  627.  
  628.                               (Page 20)
  629.  
  630.      Palette - Selecting this command will open the DiskMaster Palette
  631.      requester.
  632.  
  633.      By default, DiskMaster uses the first four colors of your
  634.      Workbench palette.  The Palette requester is described in detail
  635.      in section 4.3. of this manual.
  636.  
  637.      Printer Setup - Selecting this command will open the printer
  638.      setup requester.
  639.  
  640.      By default, the printer setup mimics your current "Preference"
  641.      settings.  If these settings are adequate, then no change to the
  642.      printer settings are required.  The printer setup requester is
  643.      described in detail in Section 4.5 of this manual.
  644.  
  645.      Change Command - Custom
  646.  
  647.      Save Config - Custom
  648.  
  649.      Save Cmd Window - Custom
  650.  
  651.                            (Page 21)
  652.  
  653.      About - Selecting this command will display the DiskMaster 2.0
  654.      Credits window.
  655.  
  656.      Quit - Selecting this command will open a confirmation requester
  657.      asking if you are sure you want to quit at this time.
  658.  
  659.      Clicking on YES will close all DiskMaster windows and screens and
  660.      exit the program.  Clicking on NO will close the requester and
  661.      allow you to continue using DiskMaster.
  662.  
  663. 2.2.5.2. Tools Menu
  664.  
  665.      Run Selected - Selecting this command will "run" the first
  666.      selected program in the source window.  Although multiple
  667.      programs may be selected, this command affects only one selection
  668.      at a time.
  669.  
  670.      Change Font - Custom
  671.  
  672.                                (Page 22)
  673.  
  674.      New Window - Selecting this command will open a new file display
  675.      window.  This new window can be used as the source directory, the
  676.      destination directory, or a neutral display directory.  Any
  677.      number of windows can be opened, each displaying a different
  678.      directory.
  679.  
  680.      New CMD Window - Custom
  681.  
  682.      Swap S<->D - Selecting this command will swap the directory paths
  683.      between the two file display windows that were most recently
  684.      active (if no windows are "locked" these will be the source and
  685.      destination directory).  For instance, if the source window is
  686.      displaying the contents of DF1: and the destination window is
  687.      displaying the contents of DF0:, this command will cause the
  688.      source to display DF0: and the destination to display DF1:
  689.  
  690.      When multiple source and destination windows are open, the swap
  691.      will take place between the two windows that were most recently
  692.      active.
  693.  
  694.      Run DM Script - Custom
  695.  
  696. 2.2.5.3. Archive Menu
  697.  
  698.      Before using these commands you must have the appropriate archive
  699.      program available.  These archive programs are available either
  700.      as "public domain" or as "shareware".  They are NOT included as
  701.      part of the DiskMaster program.  These programs may be obtained
  702.      through your local dealer, Bulletin Board Systems, or through
  703.      your local user group.
  704.  
  705.                                (Page 23)
  706.  
  707.      LHARC Add
  708.      ARC Add
  709.      ZOO Add
  710.  
  711.      The three "Add" commands perform in much the same manner.  A
  712.      requester will appear asking for the path and file name to be
  713.      used for the archive file.  The archive program is activated and
  714.      told to create a new archive file, or add to an existing archive
  715.      file using the selected files in the source window.  During the
  716.      archive process, a console window will be opened on the
  717.      DiskMaster screen, allowing you to observe or interact with the
  718.      process (as the individual program allows).
  719.  
  720.      LHARC Extract
  721.      ARC Extract
  722.      ZOO Extract
  723.  
  724.      The three "Extract" commands perform in much the same manner.
  725.      The archive program is activated and told to extract the archived
  726.      files from the selected files in the source window.  During the
  727.      extract process, a console window will be opened on the
  728.      DiskMaster screen, allowing you to observe or interact with the
  729.      process (as the individual program allows).
  730.  
  731.      LHARC List
  732.      ARC List
  733.      ZOO List
  734.  
  735.      The three "List" commands perform in much the same manner.  The
  736.      archive program is activated and told to list the archived files
  737.      contained within the selected files in the source window.  During
  738.      the listing process, a console window will be opened on the
  739.      DiskMaster screen, allowing you to observe or interact with the
  740.      process (as the individual program allows).
  741.  
  742.                                (Page 24)
  743.  
  744. 2.2.5.4. Disk Menu
  745.  
  746.       Format - Selecting this command will open the Disk Format
  747.       requester.
  748.  
  749.       Using this requester you can format up to four floppy disks at
  750.       one time, providing that your system is equipped with four
  751.       floppy drives.  The Format requester is described in detail in
  752.       Section 4.6. of this manual.
  753.  
  754.      DiskCopy - Selecting this command will open the DiskCopy
  755.      requester.
  756.  
  757.      Using this requester, you can make a single or multiple copies of
  758.      a disk using one, two, three, or four floppy drives, providing
  759.      that your system is equipped with four floppy drives.  The
  760.      DiskCopy requester is described in detail in Section 4.7 of this
  761.      manual.
  762.  
  763.                                (Page 25)
  764.  
  765.      Note: The following four commands are examples of custom
  766.      commands, using various aspects of the Format and DiskCopy
  767.      commands.
  768.  
  769.      Format DF0: - This is a shortcut to using the Format requester.
  770.      A confirmation requester will appear asking if you are sure you
  771.      want to format the disk in DF0:.  Clicking on YES will close the
  772.      requester and proceed with the format.  All feedback during the
  773.      format will appear in the DiskMaster title bar.  Clicking on NO
  774.      will close the requester and abort the format process.  The
  775.      default name used when formatting disks using this command is
  776.      "Empty:".
  777.  
  778.      Format DF1: - This command is very similar to the Format DF0:
  779.      command except that in this example, no confirmation requester
  780.      will appear.  The format process begins immediately after
  781.      selecting the command.  All feedback during the format will
  782.      appear in the DiskMaster title bar.  The name specified by this
  783.      command is "WorkDisk:".
  784.  
  785.      Clear DF0: - This command is similar to the Format DF0: command
  786.      except that in this example, no confirmation requester will
  787.      appear, and the disk is not actually formatted.  Instead, the
  788.      "Quick" option is used, which simply clears the directory of the
  789.      disk.  This only takes a few moments to complete instead of the
  790.      normal time required to fully format a disk.  The "clear" process
  791.      begins immediately after selecting the command.  All feedback
  792.      during the format will appear in the DiskMaster title bar.  The
  793.      default name used when clearing disks using this command is
  794.      "Empty:".
  795.  
  796.      Copy DF0: DF0: - This command calls the DiskCopy function and
  797.      tells it to use the DF0: drive as both the source and destination
  798.      drive.  All feedback during the copy process is displayed in the
  799.      DiskMaster title bar.  The source disk MUST be copy protected
  800.      before DiskMaster
  801.  
  802.                                (Page 26)
  803.  
  804.      will attempt to read it.  After reading the source disk, the
  805.      message "Insert Destination Disk in DF0:" will appear in the
  806.      title bar.  Remove the source disk and replace it with the
  807.      destination disk.  The contents of the source disk will be
  808.      written to the destination disk.
  809.  
  810.      Copy DF0: DF1: - This command is similar to the Copy DF0: DF0:
  811.      command, except that the source drive is DF0: and the destination
  812.      drive is DF1:.  Again, the source disk must be write protected
  813.      before the diskcopy can proceed.  Using this command will read
  814.      one track from the source disk and then write it to the
  815.      destination disk.  This will proceed until all eighty tracks have
  816.      been read and written.  All feedback during the copy process is
  817.      displayed in the DiskMaster title bar.
  818.  
  819. 2.2.5.5. Control Menu
  820.  
  821.      The following commands are new to DiskMaster users, and can be
  822.      considered customization commands.  However, we will discuss them
  823.      here because they can make DiskMaster operate in a mode that is
  824.      more familiar to previous CLImate users.
  825.  
  826.      Lock as Source - Locks active window as a source window.
  827.  
  828.      Lock as Dest - Locks active window as a destination window.
  829.  
  830.      Using these commands, a file display window can be locked as
  831.      either a source window or a destination window.  When a window is
  832.      locked, clicking into it or into another window will not change
  833.      the status of the window.  When only two windows exist, locking
  834.      one of them effectively locks the other as the opposite status.
  835.      However, when more than two file display windows are
  836.  
  837.                                (Page 27)
  838.  
  839.      opened, the locking of a window as either source or destination
  840.      can allow you to have multiple source windows or multiple
  841.      destination windows.
  842.  
  843.      These multiple source and destination windows work just as you
  844.      would expect.  Using the copy command, for instance, all files
  845.      selected in multiple source windows will each be copied to each
  846.      of the multiple destination windows.
  847.  
  848.      Unlock - Unlocks the active window.
  849.  
  850.      Unlock All - Unlocks all windows.
  851.  
  852.      Toggle Expand - Specifies whether or not DiskMaster will expand
  853.      device names such as DF0: into full volume names.  This also
  854.      affects the use of logical devices such as "Fonts:" as root
  855.      directories.  For instance, with expand ON, the "Fonts:"
  856.      designation will be expanded to the volume name of its physical
  857.      device.  However, with expand turned OFF, the directory assigned
  858.      to the "Fonts:" designation will be used as the root.
  859.  
  860.      Note: Expand must be toggled OFF if you are working with two
  861.      storage devices which have identical volume names.
  862.  
  863.                                (Page 28)
  864.  
  865. 3.   The Custom DiskMaster
  866.  
  867.      DiskMaster's default settings make it quite powerful yet easy to
  868.      use.  Without changing one thing.  DiskMaster is a very usable
  869.      program.  However, DiskMaster can be adapted to your specific
  870.      needs quite easily.  This adaptation, or configuration is stored
  871.      as a script file that can be executed by DiskMaster on startup.
  872.  
  873.      If no script is available, DiskMaster will use its internal
  874.      (default) script.  However, if a script file called "Startup.DM"
  875.      is available in the S: directory or in DiskMaster's current
  876.      directory, it will be read and executed.
  877.  
  878.      Note: When DiskMaster runs a script at startup, the credits
  879.      window will not automatically appear.
  880.  
  881. 3.1. Configuration (script) Files
  882.  
  883.      Let's start the customization of DiskMaster by duplicating the
  884.      default script externally.  Select the Project\Save Config
  885.      command.  When the requester appears asking the path and name to
  886.      give the script file, type "Startup.DM" (no quotes) and press
  887.      (Return).  The current settings of DiskMaster will be written
  888.      into a script file, located in the same directory as the
  889.      DiskMaster program.  Because we named the file "Startup.DM",
  890.      DiskMaster will execute the script each time DiskMaster is
  891.      loaded.  To demonstrate this, exit DiskMaster by selecting
  892.      Project\Quit and clicking on Yes on the confirmation requester.
  893.  
  894.      Now load DiskMaster again by double-clicking on its icon.
  895.      DiskMaster will load and execute the saved "Startup.DM" script,
  896.      so that DiskMaster is set up in the same way as when the script
  897.      file was saved.  Did you
  898.  
  899.                                (Page 29)
  900.  
  901.      notice that the credits window did not appear when you loaded
  902.      DiskMaster?
  903.  
  904.      To further demonstrate this, move and resize the file display
  905.      windows and the command window so that they appear as below:
  906.  
  907.      
  908.      (a picture goes here showing two directories, but they are shown
  909.      horizontal instead of in the vertical position, like normal.)
  910.      
  911.      Now save the configuration file again.  Notice that when you
  912.      select Project\Save Config, that the requester appears with the
  913.      name of the configuration file already entered.  Click on
  914.      Continue or press (Return) to accept the current name and save
  915.      the file.
  916.  
  917.      Now exit and reload DiskMaster to observe how its window
  918.      placement was saved to the configuration file.  If either window
  919.      was displaying a directory when the configuration file was saved,
  920.      that directory will be automatically read and displayed at
  921.      startup.  This can be quite useful if you often work with a
  922.      particular directory.
  923.  
  924.                                (Page 30)
  925. 3.2. Adding Commands
  926.  
  927.      Let's make our real change to the default DiskMaster by adding a
  928.      command to the command window.  Because of the variety of
  929.      powerful public domain and commercial text editors available,
  930.      DiskMaster does not contain a text editor of its own.  Following
  931.      these instructions will add a command to the command window that
  932.      will load the text editor "ED" that comes with your Amiga.
  933.  
  934.      Select Project\Add Command.  A String requester will appear
  935.      showing a command template in its title bar.
  936.  
  937.      The command template is as follows:
  938.  
  939.      Title,##,<command string>
  940.  
  941.      Title - This is the text that will be displayed in the command
  942.      window to identify the command string.  The title is followed by
  943.      a comma (,).
  944.  
  945.      ## - This is a two digit number specifying the colors used to
  946.      display the command title.  The first digit is the foreground
  947.      color and the second digit is the background color.  The numbers
  948.      entered here are the color register numbers as displayed in
  949.      DiskMaster's palette requester.  The color specification is
  950.      followed by another comma (,).  Remember that the first color on
  951.      a 4-color screen is color 0, and the last color is 3.
  952.  
  953.      <command string> - This is the actual command that will be
  954.      executed when the command is activated.  The command string can
  955.      be a simple one word command, a
  956.  
  957.                                (Page 31)
  958.  
  959.      command with arguments, a command requiring file selection, a
  960.      command requiring confirmation, a command requiring user input
  961.      through a requester, or multiple commands separated by semicolons
  962.      (;) to be executed one after another.  The command string can
  963.      also include external commands, which are actually separate
  964.      programs that can be called from within DiskMaster.
  965.  
  966.      The command we are going to enter is of medium complexity.  Since
  967.      "ED" is a separate program, it is called an "external" command.
  968.      The "ED" program also requires an argument, the name of a file to
  969.      be edited or created.  In this case we want "ED" to use a name
  970.      that we select from the source window.
  971.  
  972.      Enter the following text into the requester then press (Return)
  973.      or click on Continue:
  974.  
  975.      Edit,10,External C:Ed %s
  976.  
  977.      Edit is the name of the command, 10 specifies that the text will
  978.      use color register 1 as the text color, and color register 0 (the
  979.      background color) as its background.  The DiskMaster command
  980.      External tells DiskMaster that the next series of characters
  981.      specifies a program that is to be run.  The path and name of that
  982.      program is C:Ed (the "Ed" program located in the C:directory).
  983.      Finally, the %s tells DiskMaster to use the first selected entry
  984.      in the source window as an argument for the "Ed" program.
  985.  
  986.      As soon as the command was accepted by pressing (Return) or by
  987.      clicking on Continue, it was added to the command window, at the
  988.      bottom of the list of commands.  Use the command window scroll
  989.      gadgets to verify that the command is indeed at the bottom of the
  990.      command list.
  991.  
  992.      Let's try out the new command by loading a text file into the
  993.      "Ed" text editor.  Insert the working copy of the
  994.  
  995.                                (Page 32)
  996.  
  997.      DiskMaster disk into a floppy drive and display the contents of
  998.      its root directory in the source window.  Find the file called
  999.      "TextFile", and click on it to select it.  Now click on the Edit
  1000.      command.  DiskMaster will start the "Ed" program and tell it to
  1001.      load "TextFile" from the working copy of the DiskMaster disk.
  1002.      However, because "Ed" opens its window on the Workbench screen
  1003.      and the DiskMaster screen is in front of the Workbench screen we
  1004.      cannot see the "Ed" program running.  Click on the DiskMaster
  1005.      screen depth gadget at the upper right corner of the DiskMaster
  1006.      screen to push the DiskMaster screen to the back.  We can now see
  1007.      the "Ed" program running.
  1008.  
  1009.      As you can see, our "Edit" command worked, but the way in which
  1010.      it worked was inconvenient in that we had to manually push the
  1011.      DiskMaster screen to the back to get to the "Ed" program.  We can
  1012.      do better!
  1013.  
  1014.      Abort the editing of the text file by clicking into the "Ed"
  1015.      window and pressing and releasing the (Esc) key then pressing and
  1016.      releasing the (Q) key, and finally pressing (Return).  Now use
  1017.      the screen depth gadgets to bring the DiskMaster screen to the
  1018.      front.
  1019.  
  1020.      Let's change our "Edit" command so that it automatically pushes
  1021.      the DiskMaster screen to the back before running "Ed", then
  1022.      brings the DiskMaster screen to the front after "Ed" is exited.
  1023.      Select the Project\Change Command menu item.  When the message in
  1024.      the title bar prompts you to select a command to change, click on
  1025.      the Edit Command.
  1026.  
  1027.      The requester used to change a command is identical to the
  1028.      requester used to add a new command except that the command to be
  1029.      edited has been entered for you.  Change the text in the 
  1030.      requester so that it reads:
  1031.  
  1032.      Edit,10,ScrBack;External C:Ed %s;ScrFront
  1033.  
  1034.                                (Page 33)
  1035.  
  1036.      Here we added two more commands to the command string, making it
  1037.      a multi-command string.  The one-word command ScrBack pushes the
  1038.      DiskMaster Screen to the back before proceeding with the "Ed"
  1039.      command.  The one word command ScrFront following the "Ed"
  1040.      command will bring the DiskMaster screen to the front, but not
  1041.      until the "Ed" program is closed.  Notice that the three commands
  1042.      are separated with Semicolons (;).  If you have not already done
  1043.      so, accept the altered command by clicking on Continue or by
  1044.      pressing (Return).
  1045.  
  1046.      Try the altered command by selecting "TextFile" and clicking on
  1047.      the Edit command.  This time DiskMaster should move to the back,
  1048.      so that the workbench screen can be seen.  The "Ed" program will
  1049.      open and read and display the text file.  When we exit the "Ed"
  1050.      program (press (Esc) then (Q) then (Return)) DiskMaster will pop
  1051.      to the front.
  1052.  
  1053.      Save the command to the configuration file by selecting
  1054.      Project\Save Config, and responding to the requester by pressing
  1055.      (Return) or clicking on Continue.
  1056.  
  1057.      Congratulations!  You have just entered and saved your first
  1058.      complex command.  Most of DiskMaster's commands are just as easy
  1059.      to use.  A complete list of DiskMaster's commands can be found in
  1060.      Section 5. of this manual.
  1061.  
  1062. 3.3. Adding Menu Commands
  1063.  
  1064.      In the previous section, we added a complex command to the
  1065.      command window.  This complex command was actually three commands
  1066.      linked together to be performed sequentially.  In this section,
  1067.      we will be adding the same complex command string to a custom
  1068.      pull-down menu.  If DiskMaster is not already loaded, load it at
  1069.      this time.
  1070.  
  1071.                                (Page 34)
  1072.  
  1073.      Adding a menu item is quite similar to adding a command to the
  1074.      command window.  The command strings for both are nearly
  1075.      identical, with only a few minor differences.  When adding a menu
  1076.      item, you must decide whether to add the new item to an existing
  1077.      menu or create a new menu for the item.  Also, menu items are all
  1078.      displayed in the same color.  However, you can assign a keyboard
  1079.      equivalent to the menu item.  To add a menu item, select
  1080.      Project\Add Menu Item.  A string requester will appear showing a
  1081.      command template in its title bar.
  1082.  
  1083.      The command template is as follows:
  1084.  
  1085.      Menu,Title,A,<command string>
  1086.  
  1087.      Menu - This is the name of an existing menu to which the new item
  1088.      is to be added, or the name of an entirely new menu.  The Menu is
  1089.      followed by a comma (,).
  1090.  
  1091.      Title - This is the text that will be displayed as the menu item
  1092.      to identify the command string.  The title is followed by a comma
  1093.      (,).
  1094.  
  1095.      A - This is an optional keyboard equivalent.  Almost any
  1096.      printable character can be used in conjunction with the (Right
  1097.      Amiga) key to invoke the menu command.
  1098.  
  1099.      <command string> - This is identical to the command string used
  1100.      when adding commands to the command window.  Any command that can
  1101.      be added to the command window can also be added to a pull-down
  1102.      menu, and vice versa.
  1103.  
  1104.                                (Page 35)
  1105.  
  1106.      Note: The entire command, including menu, title, command string,
  1107.      etc., can be no longer than 255 characters.
  1108.  
  1109.      Enter the following text into the String requester then press
  1110.      (Return) or click on Continue.
  1111.  
  1112.      Text,Edit,E,ScrBack;External C:Ed %s;ScrFront
  1113.  
  1114.      Text is the name of a new menu to be added to the DiskMaster
  1115.      menus.  Edit is the name of the command itself, and E is the
  1116.      keyboard equivalent that will be used to invoke this menu command
  1117.      without using the mouse.  The remainder of the command is the
  1118.      same command we used in the previous section.
  1119.  
  1120.      Check to see that the command has been added to the list of menus
  1121.      by pressing the Menu Button.  The menu Text Should appear at the
  1122.      end of the list of menus.  Pull down the Text menu.  The only
  1123.      entry in this menu is Edit with a keyboard equivalent of (Right
  1124.      Amiga) + (E).  Select the file called "TextFile" and invoke the
  1125.      Text\Edit command using the mouse.  It should operate identically
  1126.      to the Edit command we placed in the command window.  Exit the
  1127.      "Ed" program (press (Esc) then (Q) then (Return)), then select
  1128.      "TextFile" again and invoke the command again using the keyboard
  1129.      equivalent.  When you are satisfied that it works as advertised,
  1130.      exit "Ed", and save the new menu command to the "Startup.DM"
  1131.      file.
  1132.  
  1133. 3.4. Custom Information Display
  1134.  
  1135. 3.4.1. Display Format
  1136.  
  1137.      DiskMaster displays information about each file and directory in
  1138.      its file display windows.  The information often exceeds the
  1139.      windows ability to display it (horizontally).  Your particular
  1140.      application may require that you be able to see certain
  1141.      information without scrolling the display to the right.
  1142.  
  1143.                                (Page 36)
  1144.  
  1145.      DiskMaster 2.0 allows you to suppress unwanted information, or
  1146.      shuffle the order in which the information is displayed.  We
  1147.      alter this information using the Project/Display Format menu
  1148.      command.  After selecting this command, a requester will appear,
  1149.      displaying current format.
  1150.  
  1151.      The string window of the requester displays several format
  1152.      symbols.  The meaning of each symbol is as follows:
  1153.  
  1154.      N    File name
  1155.      S    File size
  1156.      T    Time
  1157.      D    Date
  1158.      M    Month
  1159.      Y    Year
  1160.      W    Day of week
  1161.      A    File Attributes (protection bits)
  1162.      C    File comment
  1163.  
  1164.      Let's move the file attributes (protection bits) to the left of
  1165.      the file name.  Edit the format string so that it reads as
  1166.      follows:
  1167.  
  1168.      A NS T DMY C
  1169.  
  1170.      You will not have to exit and reload DiskMaster to see the effect
  1171.      of this change.  As soon as you click on Continue or press
  1172.      (Return), the file information will be displayed in the newly
  1173.      designated order.
  1174.  
  1175.      Note that spaces are placed between file information that you
  1176.      want to be separated visually.
  1177.  
  1178.                                (Page 37)
  1179.  
  1180.      Saving the configuration file at this point will save the new
  1181.      information format.  Change the file information display format
  1182.      to suit your own preferences, then save the configuration file.
  1183.      To restore the default file display, exit DiskMaster WITHOUT
  1184.      saving the configuration file.
  1185.  
  1186. 3.4.2. Display Font
  1187.  
  1188.      In addition to being able to change which information, and in
  1189.      what order it is displayed in the file display windows, you can
  1190.      also change the text font and text size used to display this
  1191.      information.
  1192.  
  1193.      Select the Tools\Change Font menu command.  A simple requester
  1194.      will appear displaying the current font and size (topaz/8).
  1195.  
  1196.      Change the "8" to a "9", and press (Return).  The size of the
  1197.      text in the display and command windows will become slightly
  1198.      larger.  Any Non-proportional (Fixed-width) font may be used with
  1199.      DiskMaster.
  1200.  
  1201.      Note: Proportional fonts are not allowed in DiskMaster because
  1202.      they create alignment problems.
  1203.  
  1204.                                (Page 38)
  1205.  
  1206. 3.5. Exploring the Configuration File
  1207.  
  1208.      Now that we have entered both menu commands and window commands,
  1209.      let's take a look at the actual configuration file that we have
  1210.      altered.
  1211.  
  1212.      Locate the "Startup.DM" file and select, then click on the Read
  1213.      command.
  1214.  
  1215.      Note: If you have a printer, you may want to print the
  1216.      configuration file by selecting the file then clicking on Print.
  1217.  
  1218.      At first glance, this script seems formidable.  However, closer
  1219.      examination of individual commands reveals that we already know
  1220.      quite a bit about this script.
  1221.  
  1222.      The first several commands begin with the "AddMenu" command.
  1223.      Each of these commands follows the format that we used to add
  1224.      menu commands to the existing menus.  The menus appear in the
  1225.      same order on the menu bar as they are introduced in this
  1226.      configuration file.  Find the last "AddMenu" command.  This is
  1227.      the menu item that we added earlier.
  1228.  
  1229.      Now locate the "AddCmd" commands and notice how they follow the
  1230.      format we used to add commands to the command window.  Find the
  1231.      last "AddCmd" command.  This is the "Edit" command that we added
  1232.      earlier.  If you look at the other "AddCmd" commands, you will
  1233.      see that the command we added is more complicated than the
  1234.      majority of the others.
  1235.  
  1236.      Much can be learned by simply reading through a previously saved
  1237.      configuration file.  For instance, look at the "Quit" menu
  1238.      command.  The command string (minus the menu, command text and
  1239.      keyboard assignment), reads as follows:
  1240.  
  1241.                                (Page 39)
  1242.  
  1243.      Confirm "Are you sure you want to quit?" Yes No;Quit
  1244.  
  1245.      Notice that the actual command to quit appears at the very end of
  1246.      the command string.  The command which precedes the "quit"
  1247.      command is the "confirm" command.  This command opens a
  1248.      confirmation requester which displays the text "Are you sure you
  1249.      want to quit?".  The requester has two buttons which provide two
  1250.      possible responses to that question.  The first button is
  1251.      affirmative and the second button is negative.  The text which
  1252.      appears in these two buttons (Yes and No) follows the displayed
  1253.      text in the command string.  If the requester receives an
  1254.      affirmative response, the remainder of the command string will be
  1255.      executed.  However if the requester receives a negative response,
  1256.      the remainder of the command string will be disregarded.
  1257.  
  1258.      Each individual command in the configuration file can be
  1259.      dissected in the same manner.  So you see, even the complicated
  1260.      commands aren't so complicated when broken down.
  1261.  
  1262.      Section 5. of this manual lists all DiskMaster commands.  Refer
  1263.      to this section to interpret each command in the configuration
  1264.      file and predict its operation when activated.  Take a few
  1265.      moments to look over some of the commands and see if you can do
  1266.      with them as we did with the "Quit" command.
  1267.  
  1268. 3.6. Editing the Configuration File
  1269.  
  1270.      Once you have looked over the various commands that can be used
  1271.      in the configuration file, you may want to make a few changes to
  1272.      the "Startup.DM" file.
  1273.  
  1274.      Locate and select the "Startup.DM" file which we saved earlier.
  1275.      Now click on Edit or select the menu command
  1276.  
  1277.                                (Page 40)
  1278.  
  1279.      Text\Edit.  Locate the "OpenScreen" command and edit it so that
  1280.      it reads:
  1281.  
  1282.      OpenScreen 3 Lace
  1283.  
  1284.      This command will cause DiskMaster to open on an eight (8) color
  1285.      screen in interlace.
  1286.  
  1287.      Now if you like, you can change the order in which the commands
  1288.      are displayed in the command window.  If you want to place blank
  1289.      spaces between groups of commands you can insert blank "AddCmd"
  1290.      command between the groups:
  1291.  
  1292.      AddCmd, ,
  1293.  
  1294.      Note: The two commas are separated with a single space.
  1295.  
  1296.      Some other changes you may like to make include changing the
  1297.      foreground and background colors of the commands, or adding
  1298.      keyboard equivalents to some of the menu commands.
  1299.  
  1300.      You can also add, remove, or consolidate menu commands.  Do
  1301.      whatever you like!  When you have made a few of your own changes,
  1302.      save the configuration file by pressing (Esc) then (X) then
  1303.      (Return).
  1304.  
  1305.      Now exit DiskMaster, then re-load it.  All of your changes should
  1306.      appear.  Open the palette requester to verify that DiskMaster is
  1307.      on an eight (8) color screen.
  1308.  
  1309.                                (Page 41)
  1310.  
  1311.      As you can see, changing DiskMaster to meet your needs or tastes
  1312.      is really quite easy.  Before turning you loose to completely
  1313.      re-configure DiskMaster let's make one more change...
  1314.  
  1315. 3.7. Multiple Command Windows
  1316.  
  1317.      DiskMaster allows you to have more than one command window open
  1318.      at any one time.  This can be useful to split up types of
  1319.      commands, or to break a large set of commands into two separate
  1320.      windows so that all commands can be seen without scrolling.
  1321.  
  1322. 3.7.1. Creating a New Command Window
  1323.  
  1324.      To create a new command window, select the Tools\New Cmd Window
  1325.      menu command.  A new command window will be opened, and an "Add
  1326.      Command" requester will open, allowing you to enter the first
  1327.      command.  Let's add yet another "Edit" command to this window.
  1328.      Enter the following string into the "Add Command" requester and
  1329.      press (Return).
  1330.  
  1331.      Edit,10,ScrBack;External C:Ed %s;ScrFront
  1332.  
  1333.      Test the new "Edit" on the "Startup.DM" file, as we have before.
  1334.      When you are satisfied that it works properly, resize the new
  1335.      command window and move it so that it does not interfere too much
  1336.      with the other windows.
  1337.  
  1338.      This new command window can be saved in one of two ways.  It can
  1339.      be saved as part of the "Startup.DM" file using the Project\Save
  1340.      Config command, but then the window would be opened each time
  1341.      DiskMaster was loaded, and could not be re-opened if closed.  The
  1342.      second (and more flexible) method of saving this window is as a
  1343.      separate script file.  Using this method, a command can
  1344.  
  1345.                                (Page 42)
  1346.  
  1347.      be added to the current configuration that will execute the
  1348.      script, and open the window whenever it is needed.
  1349.  
  1350.      Make sure the new command window is selected (title bar is not
  1351.      ghosted), and select the Project\Save Cmd with the default name
  1352.      "CmdWindow.DM" and press (Return), or click on Continue.
  1353.  
  1354.      Now we will demonstrate how this window can be opened after the
  1355.      main configuration has taken place.  Close the new command window
  1356.      by clicking on its close gadget.  Now locate and select the
  1357.      "CmdWindow.DM" file (it will be in the same directory as
  1358.      "Startup.DM").  Select the tools\Run DM Script menu command.  The
  1359.      new command window will open exactly in the location from which
  1360.      it was saved.  By creating several command windows, each
  1361.      containing commands that are similar in nature, you can make your
  1362.      DiskMaster extremely powerful without cluttering your single
  1363.      command window with commands that will only be used in certain
  1364.      circumstances.  For instance, you may want to have a "Disk"
  1365.      command window, a "Graphic" command window, a "Text" command
  1366.      window, etc.
  1367.  
  1368.      Note: Several example command window scripts have been included
  1369.      on the DiskMaster distribution disk.
  1370.  
  1371. 3.7.2. Replacing Menus with Command Windows
  1372.  
  1373.      On the DiskMaster distribution disk we have included a number of
  1374.      DiskMaster script files.  Each of these files was created using
  1375.      the "Save Cmd Window" command.  One of these script files is
  1376.      named "Archive.DM".  Copy this file into your S: directory.
  1377.  
  1378.      Now select "Startup.DM" and invoke your "Edit" command.  Locate
  1379.      all of the "Archive" menu commands, and
  1380.  
  1381.                                (Page 43)
  1382.  
  1383.      delete them.  Now add the following command to the bottom of the
  1384.      "Tools" menu commands:
  1385.  
  1386.      AddMenu Tools,Archive,A,Batch S:Archive.DM
  1387.  
  1388.      Now save the "Startup.DM" file by pressing (Esc) then (X) then
  1389.      (Return).
  1390.  
  1391.      Exit DiskMaster, then re-load it and view your menus by holding
  1392.      down the Menu Button.  There should be no "Archive" menu.
  1393.      Instead, there is a new command in the "Tools" menu called
  1394.      "Archive".
  1395.  
  1396.      Select this new command.  A new command window will appear with
  1397.      all of the commands that were previously in the "Archive" menu.
  1398.  
  1399.      If you "read" the "Archive.DM" file (in the S: directory), you
  1400.      will notice that the commands you find there and the menu
  1401.      commands you deleted are quite similar.  Look at the top of the
  1402.      file to see how the "OpenWindow" command was used to initially
  1403.      open the new command window.
  1404.  
  1405.                                (Page 44)
  1406.  
  1407.      Using this same method, you can create other special command
  1408.      windows.  You can even create a command window that will run your
  1409.      most frequently used programs.  You may decide to set up command
  1410.      windows for text, graphics, games, etc.
  1411.  
  1412. 3.8. Keep Going
  1413.  
  1414.      This concluded our short tutorial (yes, this was a tutorial), on
  1415.      customizing DiskMaster 2.0.  But don't stop here.  The Whole
  1416.      purpose of providing a configurable disk utility program is so
  1417.      that you can make it look and operate the way YOU want.
  1418.  
  1419.      Explore the various script and configuration files we have
  1420.      provided on the DiskMaster distribution disk.  If you find a
  1421.      particular feature you would like to incorporate into your
  1422.      personal configuration, dissect the file to find out its secrets.
  1423.  
  1424.      DO NOT BE SATISFIED WITH THE DEFAULT SETTINGS.!!!!!!!
  1425.  
  1426.      You will find that editing the configuration file can become
  1427.      addicting.  The applications for a configurable DiskMaster are
  1428.      vast.  If you think of one that is unique to your application,
  1429.      let us know.  We are always interested in the different ways
  1430.      people are using our products.  If you find that you can't
  1431.      perform a desired operation, let us know.  We will often add
  1432.      features to our products based on the desires of our end users.
  1433.      After all, many of the features in DiskMaster came from the
  1434.      requests of our DiskMaster 1.x users.
  1435.  
  1436.      Whether you want to complement, complain, or suggest... Let us
  1437.      know!!! Please mail your suggestions to:
  1438.  
  1439.      Progressive Peripherals & Software, Inc.
  1440.      464 Kalamath Street
  1441.      Denver, CO 80204
  1442.  
  1443.                                (Page 45)
  1444.  
  1445. 4.    DiskMaster Requesters and Screens
  1446.  
  1447. 4.1. Confirmation Requester
  1448.  
  1449.      DiskMaster's confirmation requester allows you to add an extra
  1450.      measure of safety to potentially destructive commands such as
  1451.      "Delete" or "Quit".  The confirmation requester is used as part
  1452.      of a command string, to determine whether or not the remainder of
  1453.      the command string should be executed.  For example, the command
  1454.      below will require a response from the user before the "Delete"
  1455.      command will be executed.
  1456.  
  1457.      Confirm "All files will be lost.";Delete %s
  1458.  
  1459.      When the requester appears, it displays the text "All files will
  1460.      be lost.".
  1461.  
  1462.      If the user responds to the requester by clicking on Continue,
  1463.      the remainder of the command "Delete %s" will be performed.
  1464.      However, if the user responds to the requester by clicking on
  1465.      Cancel, the remainder of the command string will be aborted, and
  1466.      no file deletion will take place.
  1467.  
  1468.      The text in the "Continue" and "Cancel" gadgets can be changed to
  1469.      allow you to provide the proper responses to just about any
  1470.      message or question.  For example:
  1471.  
  1472.                                (Page 46)
  1473.  
  1474.      Confirm "Are you sure want to quit?" Yes No;Quit
  1475.  
  1476.      When the command to exit DiskMaster is issued, the confirmation
  1477.      requester will appear asking "Are you sure you want to quit?".
  1478.  
  1479.      In this case, the words "Yes" and "No" are more appropriate than
  1480.      "Continue" and "Cancel".
  1481.  
  1482. 4.2. String Requester
  1483.  
  1484.      The DiskMaster String Requester is used whenever a string is
  1485.      required as a pattern, protection bit, file comment, file name,
  1486.      etc.  When the requester opens, the appropriate message is
  1487.      displayed and appropriate response options are allowed.  For
  1488.      instance the "Rename" function opens the requester and prompts
  1489.      you to "Enter New Filename".
  1490.  
  1491.      The old filename is displayed in the text area, allowing you to
  1492.      edit the old filename.  This requester also provides the
  1493.      "Continue" and "Cancel" gadgets which appear on the confirmation
  1494.      requester.
  1495.  
  1496.                                (Page 47)
  1497.  
  1498.      Many operations that make use of the string requester are
  1499.      recursive.  That is, the operation is performed over and over on
  1500.      all of the selected files.  For these operations, the string
  1501.      requester has third gadget "Abort", located between the
  1502.      "Continue" and "Cancel" gadgets.  While the "Cancel" gadget will
  1503.      cancel the operation on each of the selected files one at a time,
  1504.      the "Abort" gadget cancels the operation for all of the selected
  1505.      files at once.
  1506.  
  1507.      An example of a user definable version of the string requester is
  1508.      the requester which opens in response to the "ReqPattern"
  1509.      command.  In this case the prompt text, and the text in all three
  1510.      gadgets can be altered (see the "ReqPattern" command in Section
  1511.      5. of this manual).
  1512.  
  1513. 4.3. Palette Requester
  1514.  
  1515.      The Palette requester is opened in response to the "Color"
  1516.      command.  It allows you to alter the DiskMaster screen colors
  1517.      using a point and click method.
  1518.  
  1519.      When the palette requester opens, it may contain two, four, or
  1520.      eight color registers (squares) with color "0" selected and ready
  1521.      to be edited.  To the right of the color registers (squares),
  1522.      four numbers display 1) the color register number currently
  1523.      selected, 2) the hexidecimal (0-F) Red value 3) the hexidecimal
  1524.      (0-F) Green value and 4) the hexidecimal (0-F) Blue value.  The
  1525.      three horizontal sliders occupying the lower half of the
  1526.      requester are used to alter these hexidecimal color values.  Each
  1527.      slider has a range of 16 different positions (0-F).  Click on
  1528.      each of the
  1529.  
  1530.                                (Page 48)
  1531.  
  1532.      color registers (squares) at the top of the requester.  As each
  1533.      register is selected, its number is displayed as the left most
  1534.      digit of the four numbers at the right.  The color register's
  1535.      current color (RGB) value is displayed numerically by the
  1536.      remaining three digits, and also displayed graphically by the
  1537.      position of the three slider knobs below.  The color of the
  1538.      selected register is altered by altering the position of these
  1539.      slider knobs.  They are manipulated by clicking on, and dragging
  1540.      the knob to the left or right, or by clicking to the left or
  1541.      right of the knob.  Clicking on the word Cancel will abort the
  1542.      color change, restore the previous colors and close the
  1543.      requester.  Clicking on the close gadget at the upper left of the
  1544.      requester will accept the changes and close the requester.  At
  1545.      any time while the requester is open, pressing the Menu Button of
  1546.      the mouse will cause the requester to mimic the current Workbench
  1547.      colors.
  1548.  
  1549. 4.4. File Reader
  1550.  
  1551.      Screen Options
  1552.  
  1553.      The DiskMaster file reader provides a number of viewing options.
  1554.      When reading a file, the reader screen can be interlaced,
  1555.      non-interlaced, or interlaced half screen.  The screen options
  1556.      are specified by the "Read" command.  For instance:
  1557.  
  1558.      Read %s
  1559.  
  1560.      Opens the reader screen in non-interlace.
  1561.  
  1562.      Read %s Lace
  1563.  
  1564.      Opens the reader screen in interlace.
  1565.  
  1566.                                (Page 49)
  1567.  
  1568.      Read %s Half
  1569.  
  1570.      Opens the reader as an interlaced half screen.
  1571.  
  1572.      In addition to the screen resolutions, the file reader also
  1573.      allows you to view text or binary files in hexadecimal.  Using
  1574.      this screen option, the hexidecimal information will be displayed
  1575.      on the left portion of the screen, with its corresponding ASCII
  1576.      display to the right.  Again, this option is activated as part of
  1577.      the "Read" command.
  1578.  
  1579.      Read %s Lace Hex
  1580.  
  1581.      Opens the reader in interlace and in hexadecimal display mode.
  1582.  
  1583.      Scrolling Options
  1584.  
  1585.      Once the reader has loaded the file and opened its screen, the
  1586.      first page of text is displayed.  The file reader does not wrap
  1587.      the text.  If a line of text is greater in length than what can
  1588.      be displayed on your monitor, pressing the (Right Cursor) key
  1589.      will move the display window to the right by eight (8) columns.
  1590.      Likewise, pressing the (Left Cursor) key will move the display
  1591.      window to the left eight (8) columns.
  1592.  
  1593.      Scrolling the display window up or down can be accomplished using
  1594.      two methods.  The "Jump" method is associated with keyboard
  1595.      commands to move the display up or down line by line, or page by
  1596.      page.  The "Smooth" method smoothly scrolls the text up or down,
  1597.      depending on the position of the pointer.
  1598.  
  1599.      Pressing the (Space Bar) or clicking the Select Button on the
  1600.      mouse toggles between "Jump" mode and "Smooth" mode.  When in
  1601.      "Smooth" mode, placing the pointer in the center of the screen
  1602.      will pause the scroll.  Moving the pointer a short distance up or
  1603.      down from center will
  1604.  
  1605.                                (Page 50)
  1606.  
  1607.      cause the display to move slowly in the direction of the pointer
  1608.      movement.  Moving the pointer up or down to the near top or
  1609.      bottom of the screen will cause the display to quickly scroll in
  1610.      the direction of the mouse movement.
  1611.  
  1612.      Display Movement Keys:
  1613.  
  1614.      Toggle "Jump" mode / "Smooth" mode    (Space Bar)
  1615.  
  1616.      Move Left      (Left Cursor)          (Keypad 4)
  1617.      Move Right     (Right Cursor)         (Keypad 6)
  1618.  
  1619.      Line up        (Up Cursor)            (Keypad 8)
  1620.      Line down      (Down Cursor)          (Keypad 2)
  1621.  
  1622.      Page up        (Shift)+(Up Cursor)    (Keypad 9 (PgUp))
  1623.      Page down      (Shift)+(Down Cursor)  (Keypad 3 (PgDn))
  1624.  
  1625.      Top of File    (T)                    (Keypad 7 (Home))
  1626.      Bottom of File (B)                    (Keypad 1 (End))
  1627.  
  1628.      Search Options
  1629.  
  1630.      The file reader allows you to search for a particular word or
  1631.      string.  Pressing the (S) key will open a text requester asking
  1632.      you to enter the string for which to search.  After entering the
  1633.      search string, the reader will search the file for the specified
  1634.      string.  If the string is found, the portion of the file will be
  1635.      displayed where the string first occurs, with each occurrence of
  1636.      the string highlighted.  Pressing the (C) key will continue the
  1637.      search, displaying the next portion of the file in which the
  1638.      string occurs.  This can be repeated until the end of the file is
  1639.      reached.
  1640.  
  1641.      The search string requester will accept the wild card characters
  1642.      "?" (single unknown) and "*" (multiple unknown).  When in
  1643.      hexadecimal display mode, entering a hexadecimal value preceded
  1644.      with a "$" will search for that hexadecimal string.
  1645.  
  1646.                              (Page 51)
  1647.  
  1648.      Search Keys:
  1649.  
  1650.      Begin search       (S)
  1651.      Continue search    (C)
  1652.  
  1653.      To exit the file reader you can click on the close gadget at the
  1654.      upper left of the screen, or press (Q), (Esc), (Enter), or
  1655.      (Return), or the mouse.  Pressing the (Up Cursor) or (Down
  1656.      Cursor) keys will move the display up or down one line.
  1657.  
  1658. 4.5. Printer Setup Requester
  1659.  
  1660.      The Printer Setup requester allows you to alter your printer
  1661.      preference settings without entering the "Preferences" program.
  1662.  
  1663.      The default settings of the Printer Setup requester mimic your
  1664.      printer preference settings.  Alterations to the printer settings
  1665.      will remain in effect until DiskMaster is closed, unless the
  1666.      configuration file is saved after changing the settings.
  1667.  
  1668.                                (Page 52)
  1669.  
  1670.      The Printer settings and options available in the Printer Setup
  1671.      requester are as follows:
  1672.  
  1673.      File Header - Activating this button will cause DiskMaster to
  1674.      print the name of the file at the top of the first page.
  1675.  
  1676.      Page Numbers - Activating this button will cause DiskMaster to
  1677.      print page numbers at the bottom of each page.  This function
  1678.      will only take effect if the "Lines/Page" setting is greater than
  1679.      zero (0).
  1680.  
  1681.      Left Margin - This value sets the left margin of the page (in
  1682.      columns).  This value is altered by clicking on the left arrows
  1683.      "<<" to lower the value, and the right arrows ">>" to raise the
  1684.      value.
  1685.  
  1686.      Right Margin - This value sets the right margin of the page (in
  1687.      columns).  This value is altered by clicking on the left arrows
  1688.      "<<" to lower the value, and the right arrows ">>" to raise the
  1689.      value.
  1690.  
  1691.      Lines/Page - This value specifies how many text lines will be
  1692.      printed on each page before performing a "Perf Skip" (perforation
  1693.      skip).  Used with the "Lines per Inch" setting (below), this
  1694.      setting effectively sets the length of the page on which you are
  1695.      printing.  If you are using a "CutSheetFeeder" with your printer,
  1696.      or you do not want DiskMaster to perform a "perf skip", set this
  1697.      value to zero (0).  This value is altered by clicking on the left
  1698.      arrows "<<" to lower the value, and the right ">>" to raise the
  1699.      value.
  1700.  
  1701.      6/8 LPI - This setting specifies if the text is to be printed at
  1702.      six (6) lines per inch, or at eight (8) lines per inch.  This
  1703.      setting varies the amount of vertical space that is used between
  1704.      each line of text.  On an eleven (11) inch sheet of paper, "6
  1705.      LPI" will print 66 lines of text, while "8 LPI" will print 88
  1706.      lines of text.  This value is altered by clicking on the button
  1707.      itself.  The value will toggle between "6 LPI" and "8 LPI".
  1708.  
  1709.                                (Page 53)
  1710.  
  1711.      Pica/Elite/Fine - This setting specifies one of three fairly
  1712.      standard character pitch settings.  "Pica" refers to a character
  1713.      pitch of ten (10)(about 80 characters wide on a letter sized
  1714.      page).  "Elite" refers to a character pitch of twelve (12)(about
  1715.      96 characters wide on a letter sized page).  "Fine" refers to a
  1716.      character pitch of fifteen (15)(about 120 characters wide on a
  1717.      letter sized page).  This setting is altered by clicking on the
  1718.      button itself.  The setting will cycle through the three values
  1719.      as it is clicked on.
  1720.  
  1721.      Draft/NLQ - Most dot matrix printer have two character quality
  1722.      settings.  "Draft" renders a lower quality printed character but
  1723.      is quicker than "NLQ".  "NLQ" (Near Letter Quality) renders a
  1724.      nicer character, but slower printing.  On most "9 pin" printers,
  1725.      NLQ mode requires two passes of the print head for each line.
  1726.      This setting is altered by clicking on the button itself.  The
  1727.      Value will toggle between "Draft" and "NLQ".
  1728.  
  1729.      Gfx Density - This setting is identical to the "Graphic 2"
  1730.      "Density" setting in the "Preferences" program.  The range of
  1731.      values used by this setting determines the graphic density, with
  1732.      a value of "1" being the lowest density, and a value of "7" being
  1733.      the highest density.  This value is altered by clicking on the
  1734.      left arrows "<<" to lower the value, and the right arrow ">>" to
  1735.      raise the value.
  1736.  
  1737.      Command - The blank field below the "Gfx Density" setting is a
  1738.      field which allows you to enter a special printer command to be
  1739.      issued by DiskMaster at the beginning of each print job.
  1740.  
  1741.      Done - Clicking on this button will accept the printer settings
  1742.      and close the requester.
  1743.  
  1744.                                (Page 54)
  1745.  
  1746.      Cancel - Clicking on this button will ignore any changes made,
  1747.      and close the requester.
  1748.  
  1749.      A few notes on printing:
  1750.  
  1751.      If the text line being printed is greater in length than the
  1752.      space available, the text will be wrapped around to the nextline.
  1753.      DiskMaster does not automatically "word wrap" files, so if the
  1754.      right margin is reached in the middle of a word, that word will
  1755.      be broken and the remainder will be printed on the next line.
  1756.      Also, DiskMaster responds to "carriage returns", so if the
  1757.      wrapped line contains a carriage return at the end, only a few
  1758.      characters may be printed on alternating lines.
  1759.  
  1760. 4.6. Disk Format Requester
  1761.  
  1762.      The DiskMaster Format requester allows you to format or clear up
  1763.      to four (4) floppy disks at one time (providing you have four
  1764.      floppy drives).  The four buttons down the left side of the
  1765.      requester labeled DF0:, DF1:, DF2:, and DF3:, represent the four
  1766.      floppy drives.  To select one or more drives for the format
  1767.      operation, simply click on their corresponding button.  The
  1768.      selected buttons will become highlighted.
  1769.  
  1770.      The text fields to the right of each drive button is the disk
  1771.      name field.  The default name of each disk is "Empty",
  1772.  
  1773.                                (Page 55)
  1774.  
  1775.      but you can edit the names, so that each formatted disk will be
  1776.      given a different name.
  1777.  
  1778.      The format process can be changed using up to three format
  1779.      options.  They are:
  1780.  
  1781.      Quick - Tells DiskMaster to not perform a full format.  Instead,
  1782.      the directory of each disk will be cleared, and the disk will be
  1783.      given the specified name.  This option will only work on
  1784.      previously formatted disks, and can save quite a bit of time.
  1785.      However, if any errors exist in the format of the disk, they will
  1786.      not be removed from the disk.
  1787.  
  1788.      Verify - Tells DiskMaster to verify each formatted track after it
  1789.      is formatted.  This function takes place only when a full format
  1790.      is performed.  If the "Quick" option is in effect, disk
  1791.      verification will not take place.
  1792.  
  1793.      Install - Tells DiskMaster to "install" the disk after it is
  1794.      formatted or cleared.  This option will write the necessary 
  1795.      information to the "boot block" of the disk so that the Amiga
  1796.      computer is able to "boot" from this disk.
  1797.  
  1798.       After selecting the appropriate options, clicking on GO will
  1799.      perform the specified format operations on the specified disks.
  1800.      Alternately, clicking on Cancel will abort the format operation
  1801.      and close the requester.  All feedback during the format
  1802.      operation is displayed in DiskMaster's title bar.
  1803.  
  1804.                                (Page 56)
  1805.  
  1806. 4.7. DiskCopy Requester
  1807.  
  1808.      DiskMaster's DiskCopy requester allows you to make full disk
  1809.      copies using one, two, three, or four disk drives.  It also
  1810.      allows you to make multiple copies of the same disk without
  1811.      re-reading the original.
  1812.  
  1813.      The first drive button (to the right of the "Multi Copy" button),
  1814.      is the source designation.  By default, this is DF0:.  Clicking
  1815.      on this button will cycle through the four (4) disk drive
  1816.      designations.  If DF0: is to be the source drive, this button can
  1817.      be left alone.
  1818.  
  1819.      After selecting the source drive, up to four destination drives
  1820.      must be selected.  If you have only one disk drive, then DF0:
  1821.      will be the only choice available to you.  However, if you have
  1822.      two, three, or four drives, clicking on the corresponding drive
  1823.      button will select it as a destination drive.
  1824.  
  1825.      The Multi button is a special option that allows you to read the
  1826.      contents of the source disk into memory, then make multiple
  1827.      copies of that disk without re-reading the source disk for each
  1828.      set of copies.  The "Multi" option will work with one, two,
  1829.      three, or four drives.
  1830.  
  1831.      Note: If your system does not have enough free memory to use the
  1832.      "Multi" option, it will be disabled.
  1833.  
  1834.      All feedback and prompts for the DiskCopy operation is displayed
  1835.      in the DiskMaster title bar.
  1836.  
  1837.                                (Page 57)
  1838.  
  1839. 5.   DiskMaster/ARexx Commands
  1840.  
  1841.      This section lists all of the DiskMaster and ARexx commands.  All
  1842.      DiskMaster commands can be issued through ARexx.  However, there
  1843.      are a few commands which can ONLY be issued through ARexx.  The
  1844.      DiskMaster ARexx port address is "DM.  Each subsequent copy of
  1845.      DiskMaster which is run will have the ARexx port name of "DM2".,
  1846.      "DM3", etc.  The DiskMaster ScreenShare name is also "DM".
  1847.  
  1848.      In the commands below, arguments enclosed in "<>" are required
  1849.      arguments, while those enclosed in "()" are optional arguments.
  1850.  
  1851. ---------------------------------------------------------------------
  1852.      AddAutoCmd
  1853.  
  1854.      Function:  Adds an AutoCommand to the list.  When a file
  1855.      double-clicked, DiskMaster attempts to determine what type of
  1856.      file it is by matching the first few bytes of the file to a list
  1857.      of known patterns.  If those few bytes match any of the patterns,
  1858.      the corresponding AutoCommand will be executed upon that file.
  1859.  
  1860.      Syntax: AddAutoCmd (pattern,command_String)
  1861.  
  1862.      Arguments:
  1863.  
  1864.      pattern - The pattern compared against the few bytes of the file
  1865.      to determine whether or not this AutoCommand is to be executed.
  1866.      The "?" wild card character may be used to represent a single
  1867.      unknown character.  Control characters are preceded by the "^"
  1868.      character.  Two special flags may be used in place of the
  1869.      pattern; TEXT and DEFAULT.  The TEXT AutoCommand will be executed
  1870.      if no other patterns are matched and the file is a text file.
  1871.      The DEFAULT AutoCommand will be executed if no other patterns are
  1872.      matched.  Commands using the TEXT or DEFAULT flags should be
  1873.      placed at the bottom of the AutoCommand List.
  1874.  
  1875.      Command_string - The command that will be executed if the
  1876.      preceding pattern is matched.
  1877.  
  1878.      If this command is issued with no arguments, a requester will
  1879.      appear asking for the proper arguments.
  1880.  
  1881.                                (Page 58)
  1882.  
  1883.      Example:
  1884.  
  1885.           AddAutoCmd FORM????ILBM,ShowPic %s
  1886.  
  1887.      After double-clicking on a file, DiskMaster will read the first
  1888.      few bytes of the file and attempt to match it with the pattern
  1889.      "FORM????ILBM", which is the pattern for Iff ILBM pictures.  If
  1890.      the pattern is matched, the command string "ShowPic %s" will be
  1891.      executed.
  1892.  
  1893. ---------------------------------------------------------------------
  1894.      AddCmd
  1895.  
  1896.      Function: adds a command to the current command window.
  1897.  
  1898.      Syntax: AddCmd (Title,##,command_String)
  1899.  
  1900.      Arguments:
  1901.  
  1902.      Title - The text that will appear in the command window to
  1903.      identify this command.
  1904.  
  1905.      ## - A two digit number, specifying the foreground and background
  1906.      colors to be used to display the "title" text.  The two numbers
  1907.      used are DiskMaster color palette register values.
  1908.  
  1909.      Command_String - The DiskMaster command(s) that will be executed
  1910.      when this command is activated.
  1911.  
  1912.      Example:
  1913.  
  1914.           AddCmd SYS:Libs,12,NewDir SYS:Libs
  1915.  
  1916.      Adds a command called "SYS:Libs" to the current command window,
  1917.      which when activated, changes the current window directory to
  1918.      SYS:Libs.  The text "SYS:Libs" will be displayed using color 1 as
  1919.      its foreground color and color 2 as its background color.
  1920.  
  1921. ---------------------------------------------------------------------
  1922.      AddMenuCmd
  1923.  
  1924.      Function: Adds a new menu or menu entry to the current menu
  1925.      strip.
  1926.  
  1927.      Syntax: AddMenuCmd (menu_name,title,key,command_string)
  1928.  
  1929.                                (Page 59)
  1930.  
  1931.      Arguments:
  1932.  
  1933.      menu_name - The name of an existing menu to which to add the new
  1934.      menu item, or the name of a new menu heading to be added for this
  1935.      menu item.
  1936.  
  1937.      title - The text that will appear in the menu to identify this
  1938.      command.
  1939.  
  1940.      key - A single printable character to be used in conjunction with
  1941.      the (Right Amiga) key to activate this command from the keyboard.
  1942.      The character used is not case sensitive.  However, special
  1943.      characters such as "&" or "¢" will require the use of the (Shift)
  1944.      or (Alt) keys to invoke the command.
  1945.  
  1946.      command_string - The DiskMaster command(s) that will be executed
  1947.      when this command is activated.
  1948.  
  1949.      Example:
  1950.  
  1951.           AddMenuCmd Project, DiskCopy,D,DiskCopy DF0: DF1:
  1952.  
  1953.      Adds an item called "DiskCopy" under the "Project" menu, which
  1954.      can be activated by pressing (Right Amiga)+(D).  When activated,
  1955.      will copy the contents of the floppy disk in drive DF0: to the
  1956.      floppy disk in drive DF1:
  1957.  
  1958.      Note: In the script, adding menus prior to opening any windows
  1959.      will substantially increase the speed of the script execution.
  1960.  
  1961. ---------------------------------------------------------------------
  1962.      Archive
  1963.  
  1964.      Function: Allows multiple source selections to be used with a
  1965.      single execution of a command.  This command is tailor made to be
  1966.      used with archive programs during their "Add" function.
  1967.  
  1968.      Syntax: Archive (ArcCommand)
  1969.  
  1970.      Arguments:
  1971.  
  1972.      ArcCommand - The external archive command with its normal "Add"
  1973.      arguments.
  1974.  
  1975.                                (Page 60)
  1976.  
  1977.      Example:
  1978.  
  1979.             Archive "Lharc <* -ra"
  1980.  
  1981.      Opens a requester asking for the archive name, than adds all
  1982.      selected files to the existing archive file, or creates a new
  1983.      archive file.
  1984.  
  1985. ---------------------------------------------------------------------
  1986.      BarFormat
  1987.  
  1988.      Function: Specifies which information and in what order it is to
  1989.      appear in the title bar of the Workbench or DiskMaster screen.
  1990.  
  1991.      Syntax: BarFormat (text)(%C)(%F)(%P)(%T)(%D)(%M)(%Y)(%W)
  1992.  
  1993.      Arguments:
  1994.  
  1995.      text - Any text which is to be displayed in the title bar.
  1996.      %C - Numeric value indicating the available CHIP RAM.
  1997.      %F - Numeric value indicating the available FAST RAM.
  1998.      %P - Numeric value indicating the total (public) available RAM.
  1999.      %T - Displays the current time.
  2000.      %D - displays the current date.
  2001.      %M - Displays the current month (abbreviated).
  2002.      %Y - Displays the current year.
  2003.      %W - displays the current weekday (abbreviated).
  2004.  
  2005.      Example:
  2006.  
  2007.           BarFormat DiskMaster 2.0 %M %D, %Y %P Bytes Available %T
  2008.  
  2009.      Specifies that a mixture of text and system information will be
  2010.      displayed in the title bar.  Below is an example of what that
  2011.      might look like.
  2012.  
  2013.           DiskMaster 2.0 Apr 20,91 5905880 Bytes Available 1:54PM
  2014.  
  2015. ---------------------------------------------------------------------
  2016.      Batch
  2017.  
  2018.      Function: Executes a DiskMaster batch file.
  2019.  
  2020.      Syntax: Batch (file)
  2021.  
  2022.                                (Page 61)
  2023.  
  2024.      Arguments:
  2025.  
  2026.      file - The name of the DiskMaster script file to be executed.
  2027.      The "%s" flag may be used in place of this argument to specify
  2028.      that all selected files in the source window are to be executed.
  2029.  
  2030.      Example:
  2031.  
  2032.           Batch %s
  2033.  
  2034.      Executes the selected files in the source window as DiskMaster
  2035.      script files.
  2036.  
  2037. ---------------------------------------------------------------------
  2038.      Button
  2039.  
  2040.      Function: Assigns a function to the S (source) and D
  2041.      (destination) gadgets.  Clicking on the S or D gadget will invoke
  2042.      the command.
  2043.  
  2044.      Syntax: Button <command_string>
  2045.  
  2046.      Arguments:
  2047.  
  2048.      command_string - The DiskMaster command(s) that will be executed
  2049.      when this command is activated.
  2050.  
  2051.      Example:
  2052.  
  2053.           Button "Parent"
  2054.  
  2055.      When the S or D gadget is selected, the "Parent" function is
  2056.      performed.
  2057.  
  2058. ---------------------------------------------------------------------
  2059.      Check
  2060.  
  2061.      Function: Totals the number of bytes in the specified files or
  2062.      path and determines whether or not there is room on the
  2063.      destination device to hold the files if copied.  If there is
  2064.      enough room, the amount of storage space that will be left is
  2065.      displayed.  If there is not enough room, you will be informed.
  2066.      All feedback is displayed in the DiskMaster screen title bar.
  2067.  
  2068.      Syntax: Check <path>
  2069.  
  2070.                                (Page 62)
  2071.  
  2072.      Arguments:
  2073.  
  2074.      path - The AmigaDOS path which is to be totaled and compared to
  2075.      the destination.
  2076.  
  2077.      Example:
  2078.  
  2079.           Check %s
  2080.  
  2081.      Totals the byte count of the selected files and directories and
  2082.      indicates whether or not they will fit in the destination
  2083.      directory.
  2084.  
  2085. ---------------------------------------------------------------------
  2086.      ChgCmd
  2087.  
  2088.      Function: Requests that you select a command to be altered, then
  2089.      opens a requester allowing you to edit the command without
  2090.      editing the configuration file directly.
  2091.  
  2092.      Syntax: ChgCmd
  2093.  
  2094.      Arguments:
  2095.  
  2096.      NONE
  2097.  
  2098.      Example:
  2099.  
  2100.           ChgCmd
  2101.  
  2102.      Requests that you select a command to be altered, then opens a
  2103.      requester allowing you to edit the command without editing the
  2104.      configuration file directly.
  2105.  
  2106. ---------------------------------------------------------------------
  2107.      CloseWindow
  2108.  
  2109.      Function: Closes the current window.
  2110.  
  2111.      Syntax: CloseWindow
  2112.  
  2113.      Arguments:
  2114.  
  2115.      NONE
  2116.  
  2117.                                (Page 63)
  2118.  
  2119.      Example:
  2120.  
  2121.           CloseWindow
  2122.  
  2123.      Closes the current window.
  2124.  
  2125. ---------------------------------------------------------------------
  2126.      Color
  2127.  
  2128.      Function: Sets the RGB values (in hexadecimal) of each color
  2129.      register.
  2130.  
  2131.      Syntax: Color (colors)
  2132.  
  2133.      Arguments:
  2134.  
  2135.      (no arg) - Opens the palette requester allowing you to visually
  2136.      change the color palette.
  2137.  
  2138.      colors - The set of hexadecimal values specifying the RGB value
  2139.      of the color palette registers.  The color registers are set from
  2140.      left to right with each RGB value separated with a space.
  2141.  
  2142.      Example:
  2143.  
  2144.           Color
  2145.  
  2146.      Opens the color palette
  2147.  
  2148.           Color 0 fff f 986
  2149.  
  2150.      Sets the first 4 colors:
  2151.  
  2152.      0=R0 G0 B0; 1=RF GF BF; 2=R0 G0 BF; 3=R9 G8 B5
  2153.  
  2154. ---------------------------------------------------------------------
  2155.      Comment       (Recursive)
  2156.  
  2157.      Function: Changes the comment text of the specified file.
  2158.  
  2159.      Syntax: Comment file ("text")
  2160.  
  2161.      Arguments:
  2162.  
  2163.      (no arg) - Opens a requester with the current comment to be
  2164.      edited.
  2165.  
  2166.                                (Page 64)
  2167.  
  2168.      file - The name of the file whose comment is to be changed.  The
  2169.      "%s" flag may be used in place of this argument to specify that
  2170.      all selected files the source window are to be changed.
  2171.  
  2172.      Example:
  2173.  
  2174.           Comment %s
  2175.  
  2176.      Opens a requester with the current comment to be edited.
  2177.  
  2178.           Comment %s "This is a comment"
  2179.  
  2180.      Sets the comment "This is a comment" for each selected file.
  2181.  
  2182. ---------------------------------------------------------------------
  2183.      Confirm
  2184.  
  2185.      Function: Opens a requester displaying a message, a "Continue"
  2186.      gadget and a "Stop" gadget.  All text in this requester can be
  2187.      customized.  If the user selects the "Continue" gadget the
  2188.      requester will disappear and the remainder of the command string
  2189.      will be executed.  If the user selects the "Stop" gadget, the
  2190.      requester will disappear and the remainder of the command string
  2191.      will be disregarded.
  2192.  
  2193.      Syntax: Confirm<"text">(Continue)(Stop)
  2194.  
  2195.      Arguments:
  2196.  
  2197.      text - The text that will appear in the requester.  If the text
  2198.      is to contain spaces, it must be enclosed in quotes.
  2199.  
  2200.      Continue - The text that will be displayed in the "Continue"
  2201.      gadget.
  2202.  
  2203.      Stop - The text that will be displayed in the "Stop" gadget.  If
  2204.      this text is specified, the "Continue" text must also be
  2205.      specified.
  2206.  
  2207.      Example:
  2208.  
  2209.           Confirm "Are you sure" "Yes" "No"
  2210.  
  2211.      Displays a requester displaying the message "Are you sure", a
  2212.      "Yes" gadget and a "No" gadget.  If the user selects the "Yes"
  2213.      gadget the requester will disappear and the remainder of the
  2214.      command string will be executed.  If the user selects the "No"
  2215.      gadget, the requester will disappear and the remainder of the
  2216.      command string will be disregarded.
  2217.  
  2218.                                (Page 65)
  2219.  
  2220. ---------------------------------------------------------------------
  2221.      Copy       (Recursive/Auto-Makedir)
  2222.  
  2223.      Function: Copies the specified file(s) to the specified
  2224.      destination.
  2225.  
  2226.      Syntax: Copy<source><dest>(NEWER)
  2227.  
  2228.      Arguments:
  2229.  
  2230.      source - The name of the file or path to be copied.  The "%s"
  2231.      flag may be used in place of this argument to specify that all
  2232.      selected files the source window are to be copied.
  2233.  
  2234.      dest - The destination path.  The "%d" flag may be used in place
  2235.      of this argument to specify that the path specified by the
  2236.      destination window is to be used.
  2237.  
  2238.      NEWER - This flag specified that file will be copied only if the
  2239.      source file is newer than the file of the same name in the
  2240.      destination directory, or if the file does not exist.
  2241.  
  2242.      Example:
  2243.  
  2244.           Copy %s %d
  2245.  
  2246.      Copies selected source files to the destination directory.
  2247.  
  2248.           Copy DF0: DF1:
  2249.  
  2250.      Copies all files from DF0: to DF1:.
  2251.  
  2252. ---------------------------------------------------------------------
  2253.      Delete
  2254.  
  2255.      Function: Deletes the specified file(s).
  2256.  
  2257.      Syntax: Delete <file>
  2258.  
  2259.      Arguments:
  2260.  
  2261.      file - The name of the file or path to be deleted.  The "%s" flag
  2262.      may be used in place of this argument to specify that all
  2263.      selected files in the source window are to be deleted.
  2264.  
  2265.                                (Page 66)
  2266.  
  2267.      Example:
  2268.  
  2269.           Delete %s
  2270.  
  2271.      Deletes selected files and directories in the source window.
  2272.  
  2273. ---------------------------------------------------------------------
  2274.      Deselect
  2275.  
  2276.      Function: Deselects files and directories based on pattern
  2277.      matching.
  2278.  
  2279.      Syntax: Deselect (pattern)
  2280.  
  2281.      Arguments:
  2282.  
  2283.      (no arg) - Opens a requester asking for a pattern to match.
  2284.  
  2285.      pattern - Any printable text may be used as the pattern to be
  2286.      matched.  The wild card characters "?" (single unknown) and "*"
  2287.      (multiple unknown) may also be used.
  2288.  
  2289.      Example:
  2290.  
  2291.           Deselect *
  2292.  
  2293.      Deselects all files and directories in the current window.
  2294.  
  2295.           Deselect
  2296.  
  2297.      Opens a requester asking for a pattern match.
  2298.  
  2299.           Deselect * .info
  2300.  
  2301.      Deselects all files and directories ending with ".info".
  2302.  
  2303. ---------------------------------------------------------------------
  2304.      DirList            (ARexx only)
  2305.  
  2306.      Function: Gets the contents of the current window with
  2307.      selected/deselected status.
  2308.  
  2309.      Syntax: DirList(variable)
  2310.  
  2311.      Arguments:
  2312.  
  2313.      variable - Name of the list variable to be used by the ARexx
  2314.      program for the information obtained from the DiskMaster window.
  2315.  
  2316.                                (Page 67)
  2317.  
  2318.      Example:
  2319.  
  2320.           Address DM
  2321.           DirList List
  2322.           do i=1 to List.0
  2323.             parse var List.i name +30 size +8 time +9 date +7 prot +9
  2324.             cmt +80 dir0 +1 sel
  2325.             say name size time date prot dir sel
  2326.           end
  2327.  
  2328.      Displays directory of current window in console window.
  2329.  
  2330. ---------------------------------------------------------------------
  2331.      DiskCopy
  2332.  
  2333.      Function: Performs sector copy from floppy disk to destination
  2334.      floppy disk(s).  Multiple copies may be made using the "Multi"
  2335.      function.
  2336.  
  2337.      Syntax:
  2338.  
  2339.           DiskCopy <source><dest0>(dest1)(dest2)(dest3)(MULTI)
  2340.  
  2341.      Arguments:
  2342.  
  2343.      (no arg) - Opens a diskcopy requester allowing you to visually
  2344.      set all diskcopy options.
  2345.  
  2346.      source - The floppy drive to be used at the source drive.
  2347.  
  2348.      dest0 - The first floppy drive to be used as the destination
  2349.      drive.
  2350.  
  2351.      dest1,dest2,dest3 - Optional destination drives.
  2352.  
  2353.      MULTI - Multiple Copy flag allowing more than one set of copies
  2354.      to be made from a single reading of the source disk.
  2355.  
  2356.      Example:
  2357.  
  2358.           Diskcopy DF0: DF0: DF1: MULTI
  2359.  
  2360.      Reads the disk in DF0: into memory, then writes to DF0: and DF1:
  2361.      (with prompts).  After each set of copies is complete, you will
  2362.      be prompted to insert additional disks into DF0: and DF1: to make
  2363.      additional copies.  Pressing (ESC) will abort the operation.
  2364.  
  2365.                                (Page 68)
  2366.  
  2367. ---------------------------------------------------------------------
  2368.      Expand
  2369.  
  2370.      Function: Specifies whether the expanded AmigaDOS volume and path
  2371.      names or unexpanded device names will be used to display
  2372.      directory paths.  For instance, DF0: is an unexpanded path.  If
  2373.      Expand is turned "ON", "DF0: would be replaced with the volume
  2374.      name of the disk within drive DF0:.
  2375.  
  2376.      Syntax: Expand (ON|OFF)
  2377.  
  2378.      Arguments:
  2379.  
  2380.      (no arg) - Toggles between the two modes
  2381.  
  2382.      ON - Specifies that all paths are to be expanded to their
  2383.      fullest.
  2384.  
  2385.      OFF - Specifies that physical and logical device names will be
  2386.      used as part of the directory path.
  2387.  
  2388.      Example:
  2389.  
  2390.           Expand ON
  2391.  
  2392.      Tell DiskMaster to expand all path names.
  2393.  
  2394.           Expand
  2395.  
  2396.      Toggles between the "ON" and "OFF" state.
  2397.  
  2398. ---------------------------------------------------------------------
  2399.      External        (Recursive)
  2400.  
  2401.      Function: Allows the use of external programs to be used as
  2402.      DiskMaster commands.
  2403.  
  2404.      Syntax: External (command)(args)
  2405.  
  2406.      Arguments:
  2407.  
  2408.      command - The external program that is to be executed.
  2409.  
  2410.      args - Arguments normally used by the external program.  The "%s"
  2411.      and "%D" flags may be used to specify source and destination
  2412.      directories, or selected source files or directories.
  2413.  
  2414.                                (Page 69)                J.M.S.oftware
  2415.  
  2416.      Note: Multiple external commands may be run from the same command
  2417.      string.  However, they must be separated by placing a "|" between
  2418.      each external command.
  2419.  
  2420.      Example:
  2421.  
  2422.           External C:Ed %s
  2423.  
  2424.      Runs the "Ed" command providing the first selected file in the
  2425.      source window as the name of the file to be edited.
  2426.  
  2427.           External Stack 15000\C:Ed Startup.DM
  2428.  
  2429.      Runs multiple external commands.  First sets stack to 15000, then
  2430.      runs the "Ed" program telling it to load the "Startup.DM" file.
  2431.  
  2432. ---------------------------------------------------------------------
  2433.      Find           (Recursive)
  2434.  
  2435.      Function: Searches the path for files containing the current
  2436.      pattern.  When a file is found which matches the specified
  2437.      pattern, a requester will appear asking if you want to continue
  2438.      the search, abort the search or open a window displaying the
  2439.      directory where the file was found.
  2440.  
  2441.      Note: A new pattern can be obtained using the "SetPattern" or the
  2442.      "ReqPattern" commands.
  2443.  
  2444.      Syntax: Find    (path)
  2445.  
  2446.      Arguments:
  2447.  
  2448.      path - The path to be searched.  The "%s" flag may be used in
  2449.      place of this argument to specify that all selected directories
  2450.      in the source window are to be searched.
  2451.  
  2452.      Example:
  2453.  
  2454.           Find %s
  2455.  
  2456.      Search the selected paths using the current pattern.
  2457.  
  2458.           SetPattern "*.txt;Find DF0:
  2459.  
  2460.      Search DF0: for files ending with ".txt".
  2461.  
  2462.                                (Page 70)
  2463.  
  2464. ---------------------------------------------------------------------
  2465.      Font
  2466.  
  2467.      Function: Changes the font to be used for file and command
  2468.      display.
  2469.      Note: The use of proportional fonts is NOT recommended as they
  2470.      will cause alignment problems.
  2471.  
  2472.      Syntax: Font (name/size)
  2473.  
  2474.      Arguments:
  2475.  
  2476.      name/size - The name and size of the non-proportional
  2477.      (fixed-width) font to be used for the file and command display.
  2478.      The font must be located in the "Fonts:" directory.
  2479.      If the font is not found, the default font is used.
  2480.  
  2481.      Example:
  2482.  
  2483.           Font clean/8
  2484.  
  2485.      Set font to clean.font, 8 point.
  2486.  
  2487.           Font %s
  2488.  
  2489.      Set font selected file (i.e. SYS:Fonts/topaz/8, or
  2490.      Fonts:topaz.font).
  2491.  
  2492. ---------------------------------------------------------------------
  2493.      Format
  2494.  
  2495.      Function: Formats one or more floppy disks.
  2496.  
  2497.      Syntax: Format<DFx:>(name)(DFx:1)(name)...(options)
  2498.  
  2499.      Arguments:
  2500.  
  2501.      (no arg) - Opens the Format requester, allowing you to visually
  2502.      set the format options.
  2503.  
  2504.      DFx: - The first or only drive to be used to format a disk.
  2505.  
  2506.      name - Name to be given to the disk being formatted in the
  2507.      previously specified drive.
  2508.  
  2509.      DFx:1 - Optional second, third, or fourth drive to be used to
  2510.      format disks.
  2511.  
  2512.                                (Page 71)
  2513.  
  2514.      options - Specifies that one or more of the following format
  2515.      options are to be used:
  2516.  
  2517.      INSTALL - Makes the newly formatted disk "bootable".
  2518.      QUICK - Specifies that the directory of the disk will be cleared
  2519.              instead of a full format being performed.
  2520.      VERIFY - Specifies that the disk is to be verified during format.
  2521.  
  2522.      Example:
  2523.  
  2524.           Format
  2525.  
  2526.      Opens DiskMaster's format requester.
  2527.  
  2528.           Format DF0:Empty0 DF1:Empty1 DF2:Empty2 INSTALL QUICK
  2529.  
  2530.      Formats disks in DF0:, DF1: and DF2: with different names,
  2531.      installing each, and using the QUICK option.
  2532.  
  2533. ---------------------------------------------------------------------
  2534.      Lock
  2535.  
  2536.      Function: Locks a window as either a source or destination
  2537.      window.  This function allows for the use of multiple source
  2538.      and/or destination windows.
  2539.  
  2540.      Syntax: Lock (S|D)
  2541.  
  2542.      Arguments:
  2543.  
  2544.      S - Locks window as source window.
  2545.  
  2546.      D - Locks window as destination window.
  2547.  
  2548.      Example:
  2549.  
  2550.           Lock S
  2551.  
  2552.      Locks last selected window as a SOURCE window.
  2553.  
  2554.           Lock D
  2555.  
  2556.      Locks last selected window as a DESTINATION window.
  2557.  
  2558.                                (Page 72)
  2559.  
  2560. ---------------------------------------------------------------------
  2561.      MakeDir
  2562.  
  2563.      Function: Creates a new directory.
  2564.  
  2565.      Syntax: MakeDir (name)
  2566.  
  2567.      Arguments:
  2568.  
  2569.      name - The name to be given to the new directory.
  2570.  
  2571.      Example:
  2572.  
  2573.           MakeDir
  2574.  
  2575.      Opens a requester asking for the name of the new directory.
  2576.  
  2577.           MakeDir RAM:T
  2578.  
  2579.      Makes a directory in RAM: called "T".
  2580.  
  2581. ---------------------------------------------------------------------
  2582.      Move       (Recursive)
  2583.  
  2584.      Function: Copies the specified file(s) from the source to the
  2585.      destination then deletes the specified file(s) from the source.
  2586.  
  2587.      Syntax: Move source dest (NEWER)
  2588.  
  2589.      Arguments:
  2590.  
  2591.      source - The file to be moved.  The "%s" flag may be used in
  2592.      place of this argument to specify that all selected files in the
  2593.      source window are to be moved.
  2594.  
  2595.      dest - The destination file or directory.  The "%d" flag may be
  2596.      used in place of this argument to specify that the file(s) will
  2597.      be moved to the directory specified by the destination window.
  2598.  
  2599.      NEWER - This flag specifies that only files of like names which
  2600.      have a newer file date than the existing files are to be moved.
  2601.  
  2602.                                (Page 73)
  2603.  
  2604.      Example:
  2605.  
  2606.           Move %s %d
  2607.  
  2608.      Moves selected files from the source window to the destination
  2609.      window.
  2610.  
  2611.           Move %s RAM:
  2612.  
  2613.      Moves selected files from the source window to the RAM:
  2614.      directory.
  2615.  
  2616.           Move %s
  2617.  
  2618.      Requests the destination directory, then moves selected files
  2619.      from the source window to that destination.
  2620.  
  2621. ---------------------------------------------------------------------
  2622.      Msg
  2623.  
  2624.      Function: Displays text in the DiskMaster screen title bar.
  2625.  
  2626.      Syntax: Msg "text"
  2627.  
  2628.      Arguments:
  2629.  
  2630.      text - Any text which is to be displayed in the DiskMaster screen
  2631.      title bar.
  2632.  
  2633.      Example:
  2634.  
  2635.           Msg "Do something!"
  2636.  
  2637.      Displays the message "Do something!" in the DiskMaster screen
  2638.      title bar.
  2639.  
  2640. ---------------------------------------------------------------------
  2641.      NewDir
  2642.  
  2643.      Function: Changes the directory path of the source window
  2644.  
  2645.      Syntax: NewDir(path|dmfile)
  2646.  
  2647.      Arguments:
  2648.  
  2649.      path - AmigaDOS path name.
  2650.  
  2651.                                (Page 74)
  2652.  
  2653.      dmfile - DiskMaster script file to be executed in lieu of reading
  2654.      a new directory.
  2655.  
  2656.      Example:
  2657.  
  2658.           NewDir
  2659.  
  2660.      Changes the path of the current window to "none" which displays
  2661.      the device list.
  2662.  
  2663.           NewDir RAM:*.info
  2664.  
  2665.      Changes the path of the current window to RAM: (displays only
  2666.      .info files).
  2667.  
  2668. ---------------------------------------------------------------------
  2669.      OpenScreen
  2670.  
  2671.      Function: Opens a custom screen.
  2672.  
  2673.      Syntax: OpenScreen(planes)(LACE|HALF)
  2674.  
  2675.      Arguments:
  2676.  
  2677.      planes - The number of bitplanes to use for the custom screen.
  2678.      This determines how many colors will be available for that
  2679.      screen.  One (1) bitplane will provide two (2) colors, Two (2)
  2680.      bitplanes will provide four (4) colors, and three (3) bitplanes
  2681.      will provide eight (8) colors.
  2682.  
  2683.      LACE - Specifies that the custom screen is to be opened in
  2684.      interlace mode.
  2685.  
  2686.      HALF - If interlace mode is used, specifies that the custom
  2687.      screen is to open on the lower half of the screen only.
  2688.  
  2689.      Example:
  2690.  
  2691.           OpenScreen 3 LACE
  2692.  
  2693.      Opens an eight (8) color interlace screen.
  2694.  
  2695. ---------------------------------------------------------------------
  2696.      OpenWindow
  2697.  
  2698.      Function: Opens a file display or command window on the current
  2699.      DiskMaster screen.
  2700.  
  2701.                           (Page 75)
  2702.  
  2703.      Syntax: OpenWindow (left top width height(path|dmfile|CMD))
  2704.  
  2705.      Arguments:
  2706.  
  2707.      left - The pixel coordinate for the left boundary of the window.
  2708.  
  2709.      top - The pixel coordinate for the top boundary of the window.
  2710.  
  2711.      width - The width of the window (in pixels).
  2712.  
  2713.      height - The height of the window (in pixels).
  2714.  
  2715.      path - The DOS path to be read and displayed in the newly opened
  2716.             window.
  2717.  
  2718.      dmfile - The file name of a DiskMaster script file that will be
  2719.               executed upon the opening of the new window.
  2720.  
  2721.      CMD - Command Flag.  This flag specifies that the newly opened
  2722.            window will take over as the current command window.
  2723.  
  2724.      Example:
  2725.  
  2726.           OpenWindow 100 150 200 50 RAM:
  2727.  
  2728.      Open a new window which will load and display the directory
  2729.      "RAM:".
  2730.  
  2731.           OpenWindow 100 150 200 50 C:s*
  2732.  
  2733.      Opens a new window which will display only files which start with
  2734.      "S" in the C: directory.
  2735.  
  2736.           OpenWindow 100 150 200 50
  2737.  
  2738.      Opens a new window which will display the device list.
  2739.  
  2740.           OpenWindow 100 150 200 50 CMD
  2741.  
  2742.      Opens a new window which will take over as a new command window.
  2743.  
  2744. ---------------------------------------------------------------------
  2745.      Parent
  2746.  
  2747.      Function: Displays the contents of the parent directory in the
  2748.      current directory path of the source window.
  2749.  
  2750.                                (Page 76)
  2751.  
  2752.      Syntax: Parent
  2753.  
  2754.      Arguments:
  2755.  
  2756.      NONE
  2757.  
  2758.      Example:
  2759.  
  2760.           Parent
  2761.  
  2762.      Displays the contents of the parent directory in the current
  2763.      directory path of the source window.
  2764.  
  2765. ---------------------------------------------------------------------
  2766.      Pens
  2767.  
  2768.      Function: Allows you to customize which color register is used
  2769.      for each AmigaDOS 2.0 pen.
  2770.  
  2771.      Syntax:
  2772.  
  2773.           Pens   (color)
  2774.  
  2775.      Arguments:
  2776.  
  2777.      color - This is the DiskMaster palette register number to be used
  2778.      for the specific AmigaDOS 2.0 pen.  There may be as few as two,
  2779.      and as many as eight register numbers, depending on the number of
  2780.      bitplanes being used.
  2781.  
  2782.      The position of the color numbers specifies which AmigaDOS 2.0
  2783.      pen will be assigned that color.  The positions are as follows:
  2784.  
  2785.           1 = Detail Pen
  2786.           2 = Block Pen
  2787.           3 = Text Pen
  2788.           4 = Shine Pen
  2789.           5 = Shadow Pen
  2790.           6 = HighFill Pen
  2791.           7 = HighFill Text Pen
  2792.           8 = Background Pen
  2793.           9 = Highlight Text Pen
  2794.  
  2795.      Note: Refer to your AmigaDOS 2.0 manual for a description of the
  2796.      purpose of each of these pen attributes.
  2797.  
  2798.                                (Page 77)
  2799.  
  2800.      Example:
  2801.  
  2802.           Pens 0 1 1 0 2 1 3 0 1
  2803.  
  2804.      Assigns color registers 0-3 to AmigaDOS 2.0 pens, as specified by
  2805.      their position.
  2806.  
  2807. ---------------------------------------------------------------------
  2808.      Print
  2809.  
  2810.      Function: Prints specified file(s) (text or picture).
  2811.  
  2812.      Syntax: Print <file>(HEX)
  2813.  
  2814.      Arguments:
  2815.  
  2816.      file - Name of the file to be printed.  The "%s" flag may be used
  2817.      in place of this argument to specify that all selected files in
  2818.      the source window are to be printed.
  2819.  
  2820.      HEX - Specifies that the file is to be printed in hexadecimal
  2821.      format rather than in text or graphic format.
  2822.  
  2823.      Example:
  2824.  
  2825.           Print %s
  2826.  
  2827.      Prints all selected files in the source window.
  2828.  
  2829. ---------------------------------------------------------------------
  2830.      Priority
  2831.  
  2832.      Function: Change the current AmigaDOS priority of DiskMaster.
  2833.      Changing this priority value can have an effect on other running
  2834.      programs.  We recommend that unless you are familiar with the
  2835.      effects of changing program priorities, you should leave the
  2836.      DiskMaster priority at its default setting.
  2837.  
  2838.      Syntax: Priority (#)
  2839.  
  2840.      Arguments:
  2841.  
  2842.      (no arg) - Selecting this command will open a requester, allowing
  2843.      you to edit the current priority value.
  2844.  
  2845.      # - The new priority value.
  2846.  
  2847.                                (Page 78)
  2848.  
  2849.      Example:
  2850.  
  2851.           Priority 0
  2852.  
  2853.      Sets the DiskMaster priority to 0.
  2854.  
  2855. ---------------------------------------------------------------------
  2856.      Protect            (Recursive)
  2857.  
  2858.      Function: Changes protection/attribute bits on specified file(s).
  2859.  
  2860.      Syntax: Protect <file>("(+)(-)(hsparwed)(G)")
  2861.  
  2862.      Arguments:
  2863.  
  2864.      file - Name of the file whose protect bits are to be changed.
  2865.      The "%s" flag may be used in place of this argument to specify
  2866.      that all selected files in the source window are to be changed.
  2867.  
  2868.      + - Specifies that the following bits are to be turned ON.
  2869.  
  2870.      - - Specifies that the following bits are to be turned OFF.
  2871.  
  2872.      hsparwed - Optional list of bits to be turned ON or OFF when
  2873.      preceded by a plus (+) sign or minus (-) sign.  If the plus or
  2874.      minus signs are NOT used, the list will specify the absolute bit
  2875.      settings.  The bits have the following meanings:
  2876.  
  2877.      H - Indicates that the file should be Hidden.
  2878.      S - Indicates that the file is an AmigaDOS Script.
  2879.      P - Indicates that the file is Pure and can be made Resident.
  2880.      A - Archive Bit; used by hard disk backup programs to indicate
  2881.          whether or not the file has been backed up.  This bit is
  2882.          automatically reset to OFF if any other tool has written to
  2883.          the file.
  2884.      R - Indicates that the file may be Read.
  2885.      W - Indicates that the file may be Written to.
  2886.      E - Indicates that the file may be Executed.
  2887.      D - Indicates that the file may be Deleted.
  2888.  
  2889.      Note: If bits to be turned on or off are not specified, a
  2890.      requester will appear displaying the current protect bit
  2891.      settings, allowing you to edit them.
  2892.  
  2893.      G - Global flag.  When this flag is present, the requester will
  2894.          not appear for each selected file.  Instead, the current bit
  2895.          setting are used for all selected file(s).
  2896.  
  2897.                                (Page 79)
  2898.  
  2899.      Example:
  2900.  
  2901.           Protect %s
  2902.  
  2903.      Opens a requester, asking for protection bits to be edited for
  2904.      each selected file.
  2905.  
  2906.           Protect %s RWED
  2907.  
  2908.      Sets each file to "----RWED"
  2909.  
  2910.           Protect %s "+S-P"
  2911.  
  2912.      Turns the script bit ON and turns the pure bit OFF on each
  2913.      selected file.
  2914.  
  2915. ---------------------------------------------------------------------
  2916.      Quit
  2917.  
  2918.      Function: Exits DiskMaster
  2919.  
  2920.      Syntax: Quit
  2921.  
  2922.      Arguments:
  2923.  
  2924.      NONE
  2925.  
  2926.      Example:
  2927.  
  2928.           Quit
  2929.  
  2930.      Exits DiskMaster
  2931.  
  2932. ---------------------------------------------------------------------
  2933.      Read          (Recursive)
  2934.  
  2935.      Function: Opens DiskMaster's built-in file reader to read the
  2936.      specified file(s).  The file reader has several keyboard commands
  2937.      that make this reader quite powerful.  Refer to Section 4.4. of
  2938.      this manual for a detailed description of the text reader and its
  2939.      options.
  2940.  
  2941.      Syntax: Read  <file>(HEX)(LACE|HALF)(SEARCH("Text"))
  2942.  
  2943.      Arguments:
  2944.  
  2945.      file - Name of the rile to be read.  The "%s" flag may be used in
  2946.      place of this argument to specify that all selected files in the
  2947.      source window are to be read.
  2948.  
  2949.                                (Page 80)
  2950.  
  2951.      HEX - Specifies that the file reader is to use its "Hexadecimal"
  2952.            mode.  In this mode, the file will be displayed in both
  2953.            Hexidecimal and ASCII.
  2954.  
  2955.      LACE - Specifies that the file reader is to be opened in
  2956.             interlace mode.
  2957.  
  2958.      HALF - If interlace mode is used, specifies that the file reader
  2959.             is to open on the lower half of the screen only.
  2960.  
  2961.      SEARCH - Specifies that a search is to be made on the specified
  2962.               file(s).
  2963.  
  2964.      Text - If a search is to take place, specifies the search string.
  2965.            If SEARCH is specified, but this argument is omitted, a
  2966.             requester will appear prior to the search asking for the
  2967.             search string.
  2968.  
  2969.      Example:
  2970.  
  2971.           Read %s LACE
  2972.  
  2973.      Read selected text file(s) using an interlaced screen.
  2974.  
  2975. ---------------------------------------------------------------------
  2976.      Reset
  2977.  
  2978.      Function: Resets DiskMaster to a primitive state in which it
  2979.      contains no windows or menus.  By placing this command at the
  2980.      beginning of a script, a running DiskMaster can be completely
  2981.      re-configured.
  2982.  
  2983.      Syntax: Reset
  2984.  
  2985.      Arguments:
  2986.  
  2987.      NONE
  2988.  
  2989.      Example:      Reset
  2990.  
  2991.      Resets DiskMaster to a primitive state in which it contains no
  2992.      windows or menus.
  2993.  
  2994. ---------------------------------------------------------------------
  2995.      Recursion
  2996.  
  2997.      Function: Enables or disables recursion, allowing for functions
  2998.      to be performed on a directory without having it performed on the
  2999.      files within that directory.
  3000.  
  3001.                                (Page 81)
  3002.  
  3003.      Syntax: Recursion ON|OFF
  3004.  
  3005.      Arguments:
  3006.  
  3007.      ON - Enables recursion.
  3008.  
  3009.      OFF - Disables recursion.
  3010.  
  3011.      Example:
  3012.  
  3013.           Recursion OFF;Rename %s
  3014.  
  3015.      This will allow you to rename a directory, and will not attempt
  3016.      to rename any files within that directory.
  3017.  
  3018. ---------------------------------------------------------------------
  3019.      Rename
  3020.  
  3021.      Function: Renames specified files and/or directories.
  3022.  
  3023.      Syntax:  Rename <file>(new)
  3024.  
  3025.      Arguments:
  3026.  
  3027.      file - Name of the file or directory to be renamed.  The "%s"
  3028.      flag may be used in place of this argument to specify that all
  3029.      selected files and directories in the source window are to be
  3030.      renamed.
  3031.  
  3032.      new - The file's or directory's new name.  If this argument is
  3033.      omitted, a requester will open asking for the new name.
  3034.  
  3035.      Example:
  3036.  
  3037.           Rename %s
  3038.  
  3039.      Opens a requester asking for the new name of each selected file.
  3040.      The requester uses the old name as a default, allowing you to
  3041.      edit it.
  3042.  
  3043. ---------------------------------------------------------------------
  3044.      ReqPattern
  3045.  
  3046.      Function: Opens a requester asking for a pattern to be matched
  3047.      when directories are selected.  A default pattern, and custom
  3048.      text in the title bar and gadgets may be included.
  3049.  
  3050.                                (Page 82)
  3051.  
  3052.      Syntax: ReqPattern"text"(Pattern)(Okay Abort Cancel)
  3053.  
  3054.      Arguments:
  3055.  
  3056.      text - Text to be displayed in the requester's title bar.  If the
  3057.      text included spaces, it must be enclosed in quotes.
  3058.  
  3059.      Pattern - Any printable text may be used as the pattern to be
  3060.      matched.  The wild card characters "?" (single unknown) and "*"
  3061.      (multiple unknown) may also be used.
  3062.  
  3063.      Okay Abort Cancel - This requester is used for both recursive and
  3064.      nonrecursive operations, and contains three gadgets.  The first
  3065.      gadget accepts the pattern and closes the requester, the second
  3066.      gadget aborts the entire (recursive) operation and the third
  3067.      aborts the current operation.  The text for each of the gadgets
  3068.      can be changed, however their functions will remain the same.  If
  3069.      the default text is not to be changed, this argument does not
  3070.      need to be included.
  3071.  
  3072.      Example:
  3073.  
  3074.           ReqPattern "Please enter pattern" *.info
  3075.  
  3076.      Requests pattern to be used in the current operation with
  3077.      "*.info" as the default.
  3078.  
  3079. ---------------------------------------------------------------------
  3080.      REXX
  3081.  
  3082.      Function: Executes the specified ARexx program or string.
  3083.  
  3084.      Syntax: REXX(file|"string")
  3085.  
  3086.      Arguments:
  3087.  
  3088.      file - Name of ARexx program to be executed.
  3089.  
  3090.      string - ARexx command(s) to be executed.  The ARexx string must
  3091.      be enclosed in quotes.
  3092.  
  3093.      Example:
  3094.  
  3095.           REXX "parse arg x,say x" %s
  3096.  
  3097.      Echoes each selected filename to the console window previously
  3098.      opened with the "StdIO" command.
  3099.  
  3100.                                (Page 83)
  3101.  
  3102. ---------------------------------------------------------------------
  3103.      Root
  3104.  
  3105.      Function: Displays the root directory of the current window path.
  3106.  
  3107.      Syntax: Root
  3108.  
  3109.      Arguments:
  3110.  
  3111.      NONE
  3112.  
  3113.      Examples:
  3114.  
  3115.           Root
  3116.  
  3117.      Displays the root directory of the current window path.
  3118.  
  3119. ---------------------------------------------------------------------
  3120.      SaveConfig
  3121.  
  3122.      Function: Saves a batch file that will recreate the current
  3123.      environment exactly.
  3124.  
  3125.      Syntax: SaveConfig (file)(ICON)
  3126.  
  3127.      Arguments:
  3128.  
  3129.      (no arg) - Opens a requester asking for the name of the file to
  3130.      be written or overwritten with the environment information.  The
  3131.      file will be saved with an icon.
  3132.  
  3133.      file - Name of file to be written or overwritten with the
  3134.      environment information.
  3135.  
  3136.      ICON - Specifies that an icon is to be provided for the saved
  3137.      file.
  3138.  
  3139.      Example:
  3140.  
  3141.           SaveConfig Startup.DM ICON
  3142.  
  3143.      Saves the file as "Startup.DM" (with an icon).
  3144.  
  3145.                                (Page 84)
  3146.  
  3147. ---------------------------------------------------------------------
  3148.      ScrBack
  3149.  
  3150.      Function: Pushes the DiskMaster screen behind other existing
  3151.      screens.
  3152.  
  3153.      Syntax: ScrBack
  3154.  
  3155.      Arguments:
  3156.  
  3157.      NONE
  3158.  
  3159.      Example:
  3160.  
  3161.           ScrBack
  3162.  
  3163.      Pushes the DiskMaster screen behind other existing screens.
  3164.  
  3165. ---------------------------------------------------------------------
  3166.      ScrFront
  3167.  
  3168.      Function: Brings the DiskMaster screen to the front of other
  3169.      existing screens.
  3170.  
  3171.      Syntax: ScrFront
  3172.  
  3173.      Arguments:
  3174.  
  3175.      NONE
  3176.  
  3177.      Example:
  3178.  
  3179.           ScrFront
  3180.  
  3181.      Brings the DiskMaster screen to the front of other existing
  3182.      screens.
  3183.  
  3184. ---------------------------------------------------------------------
  3185.      Select
  3186.  
  3187.      Function: Selects file in the source window using the specified
  3188.      pattern.
  3189.  
  3190.      Syntax: Select (pattern)
  3191.  
  3192.      Arguments:
  3193.  
  3194.      pattern - Any printable text may be used as the pattern to be
  3195.      matched.  The wild card characters "?" (single unknown) and "*"
  3196.      (multiple unknown) may also be used.
  3197.  
  3198.      Example:
  3199.  
  3200.           Select *
  3201.  
  3202.      Selects all files and directories in the current window.
  3203.  
  3204.           Select
  3205.  
  3206.      Opens a requester asking for the pattern for the selection.
  3207.  
  3208.           Select *.info
  3209.  
  3210.      Selects all files and directories in the current window which end
  3211.      with ".info".
  3212.  
  3213. ---------------------------------------------------------------------
  3214.      SetDate           (Recursive)
  3215.  
  3216.      Function: Changes the file date and time of the specified
  3217.      file(s).
  3218.  
  3219.      Syntax: SetDate (file)(date)
  3220.  
  3221.      Arguments:
  3222.  
  3223.      file - Name of the file whose date is to be changed.  The "%s"
  3224.      flag may be used in place of this argument to specify all
  3225.      selected files in the source window.
  3226.  
  3227.      date - The date to be written to the specified file(s).  The date
  3228.      must be specified in the format hh:mm:ss ddmmyy.  If no date is
  3229.      supplied, the current date and time will be used.
  3230.  
  3231.      Example:
  3232.  
  3233.           SetDate %s
  3234.  
  3235.      Sets the date of all selected files in the source window to the
  3236.      current time and date.
  3237.  
  3238. ---------------------------------------------------------------------
  3239.      SetFormat
  3240.  
  3241.      Function: Specifies which, and in what order information is
  3242.      displayed in the file display windows.
  3243.  
  3244.      Syntax: SetFormat (N)(S)(T)(D)(M)(Y)(W)(A)(C)
  3245.  
  3246.                                (Page 86)
  3247.  
  3248.      Arguments:
  3249.  
  3250.      (no arg) - Opens a requester allowing you to edit the current
  3251.                 format.
  3252.      N - File name
  3253.      S - File size
  3254.      T - Time
  3255.      D - Date
  3256.      M - Month
  3257.      Y - Year
  3258.      W - Day of week
  3259.      A - File Attributes (protection bits)
  3260.      C - File comment
  3261.      Text - Any text that is to be displayed along with the file
  3262.             information.
  3263.  
  3264.      Example:
  3265.  
  3266.           SetFormat
  3267.  
  3268.      Opens a requester allowing you to edit the current format.
  3269.  
  3270.           SetFormat "S N A T W D-M-Y C"
  3271.  
  3272.      Changes format to SIZE NAME ATTRIBUTES TIME WWW DD-MMM-YY COMMENT
  3273.  
  3274. ---------------------------------------------------------------------
  3275.      SetList            (ARexx Only)
  3276.  
  3277.      Function: Displays items in a list in a file display window,
  3278.      allowing you to use it as an ARexx item selection window.  Using
  3279.      the "GetDir" command, the status of this list
  3280.      (selected/deselected) is returned to the ARexx program.
  3281.  
  3282.      Syntax: SetList <stem_name>
  3283.  
  3284.      Arguments:
  3285.  
  3286.      stem_name - The stem name of the list (defined in an ARexx
  3287.      program) to be displayed.  The list must be defined prior to
  3288.      issuing this command and must be in the following format:
  3289.  
  3290.           SList.1='One' SList.2='Two' SList.3-'Three'
  3291.  
  3292.                                (Page 87)
  3293.  
  3294.      Example:
  3295.  
  3296.           SetList SList
  3297.  
  3298.      Displays the items in "SList" in the current file display window.
  3299.  
  3300. ---------------------------------------------------------------------
  3301.      SetPattern
  3302.  
  3303.      Function: Sets the pattern for the current operation, overriding
  3304.      the pattern specified by "ReqPattern".
  3305.  
  3306.      Syntax: SetPattern pattern
  3307.  
  3308.      Arguments:
  3309.  
  3310.      pattern - Any printable text may be used as the pattern to be
  3311.      matched.  The wild card characters "?" (single unknown) and "*"
  3312.      (multiple unknown) may also be used.
  3313.  
  3314.      Example:
  3315.  
  3316.           SetPattern *.c
  3317.  
  3318.      Sets pattern for current operation to *.c.
  3319.  
  3320. ---------------------------------------------------------------------
  3321.      SetPrinter
  3322.  
  3323.      Function: Opens the printer option requester, allowing you to
  3324.      change the current printer setup.
  3325.  
  3326.      Syntax: SetPrinter
  3327.  
  3328.      Arguments:
  3329.  
  3330.      NONE
  3331.  
  3332.      Example:
  3333.  
  3334.           SetPrinter
  3335.  
  3336.                                (Page 88)
  3337.  
  3338. ---------------------------------------------------------------------
  3339.      Single
  3340.  
  3341.      Function: Many DiskMaster commands are "recursive".  That is, if
  3342.      more than one file is selected, the operation will be performed
  3343.      repeatedly, once for each selected file.  If directories are
  3344.      selected, the operation will be performed for each of the files
  3345.      within the selected directories.  This command tells the
  3346.      recursive function to occur only once when activated, regardless
  3347.      of how many files are selected.
  3348.  
  3349.      Syntax: Single
  3350.  
  3351.      Arguments:
  3352.  
  3353.      NONE
  3354.  
  3355.      Example:
  3356.  
  3357.           Single;Delete %s
  3358.  
  3359.      Would delete only one selected file, without deleting any
  3360.      directory or its contents.
  3361.  
  3362. ---------------------------------------------------------------------
  3363.      ShowPic         (Recursive)
  3364.  
  3365.      Function: Displays IFF ILBM picture files, or plays IFF 8SVX
  3366.      sound files.
  3367.  
  3368.      Syntax: ShowPic(file)(seconds)
  3369.  
  3370.      Arguments:
  3371.  
  3372.      file - Name of file to be played or displayed.  The "%s" flag may
  3373.      be used in place of this argument.
  3374.  
  3375.      seconds - The number of seconds the picture file is to be
  3376.      displayed (this argument does not affect sound files).
  3377.  
  3378.      Example:
  3379.  
  3380.           ShowPic %s
  3381.  
  3382.      Shows/Plays all selected files in the source window.
  3383.  
  3384.                                (Page 89)
  3385.  
  3386. ---------------------------------------------------------------------
  3387.      Status         (ARexx ONLY)
  3388.  
  3389.      Function: Returns string in result for ARexx programs.
  3390.  
  3391.      Syntax: Status <option>
  3392.  
  3393.      Arguments:
  3394.  
  3395.      option - "P" returns current path of source window.  "F" returns
  3396.      current file display format.
  3397.  
  3398.      Example:
  3399.  
  3400.           Status P
  3401.  
  3402.      Gets current path of source window.
  3403.  
  3404. ---------------------------------------------------------------------
  3405.      StdIO
  3406.  
  3407.      Function: Opens or closes an Input/Output window to allow
  3408.      interaction with external program.
  3409.  
  3410.      Syntax: StdIO (filespec)(CLOSE)
  3411.  
  3412.      Arguments:
  3413.  
  3414.      filespec - Standard console window information such as the
  3415.      console handler, window dimensions and window title.
  3416.  
  3417.      CLOSE - Closes previously opened I/O window.  This argument may
  3418.      appear at the end of the command string which opened the I/O
  3419.      window.
  3420.  
  3421.      Example:
  3422.  
  3423.           StdIO "CON:240/20/260/40/DiskMaster I/O"
  3424.  
  3425.      Opens a console window.
  3426.  
  3427.           StdIO CLOSE
  3428.  
  3429.      Closes the window.
  3430.  
  3431.                                (Page 90)
  3432.  
  3433.      Note: The I/O window opened by DiskMaster is NOT a CLI window.
  3434.      It is available to provide a method of program interaction for
  3435.      those programs which such, but do not supply their own method of
  3436.      communication.
  3437.  
  3438. ---------------------------------------------------------------------
  3439.      Swap
  3440.  
  3441.      Function: Swaps the directory paths between the two most recently
  3442.      active windows.  If only two windows are open, will swap the
  3443.      directory paths between the two.
  3444.  
  3445.      Syntax: Swap
  3446.  
  3447.      Arguments:
  3448.  
  3449.      NONE
  3450.  
  3451.      Example:
  3452.  
  3453.           Swap
  3454.  
  3455.      Swaps the directory paths between the two most recently active
  3456.      windows.
  3457.  
  3458. ---------------------------------------------------------------------
  3459.      TitleFormat
  3460.  
  3461.      Function: Specifies which, and in what order information is
  3462.      displayed in the file display window title bar.
  3463.  
  3464.      Syntax: TitleFormat(%C)(%F)(%I)(%B)(Text)
  3465.  
  3466.      Arguments:
  3467.  
  3468.      Text - Any text that you may want to display in the window title
  3469.             bar.
  3470.      %C - Number of files in directory.
  3471.      %F - Amount of available (free) space on the disk.
  3472.      %I - Number of files selected in the window.
  3473.      %B - Total number of bytes in the selected files.
  3474.  
  3475.      Example:
  3476.  
  3477.           TitleFormat Selected: %I of %C Files totaling %B Bytes
  3478.  
  3479.                                (Page 91)
  3480.  
  3481.      Displays a mixture of text and system information resulting in a
  3482.      window title bar that may appear as below:
  3483.  
  3484.           Selected: 5 of 20 Files totaling 24674 Bytes
  3485.  
  3486. ---------------------------------------------------------------------
  3487.      UnLock
  3488.  
  3489.      Function: Unlocks the selected window, or all windows.
  3490.  
  3491.      Syntax: UnLock (ALL)
  3492.  
  3493.      Arguments:
  3494.  
  3495.      (no arg) - Unlocks the currently selected window.
  3496.  
  3497.      ALL - Unlocks all windows.
  3498.  
  3499.      Example:
  3500.  
  3501.           UnLock ALL
  3502.  
  3503.      Unlocks all locked windows.
  3504.  
  3505. ---------------------------------------------------------------------
  3506.      UnMark
  3507.  
  3508.      Function: Enables or Disables automatic deselection of files
  3509.      during operations.  This feature allows multiple operations to be
  3510.      performed on a set of selected files without the need of
  3511.      re-selecting them after each operation.
  3512.  
  3513.      Syntax: UnMark (ON|OFF)
  3514.  
  3515.      Arguments:
  3516.  
  3517.      ON - Enables deselection.
  3518.  
  3519.      OFF - Disables deselection.
  3520.  
  3521.      Example:
  3522.  
  3523.      UnMark OFF;Copy %s %d
  3524.  
  3525.      Copies all selected files without deselecting them.
  3526.  
  3527.                                (Page 92)
  3528.  
  3529. ---------------------------------------------------------------------
  3530.      Wait
  3531.  
  3532.      Function: Causes a timed delay or a cued delay.
  3533.  
  3534.      Syntax: Wait(seconds)
  3535.  
  3536.      Arguments:
  3537.  
  3538.      seconds - The number of seconds to wait before proceeding with
  3539.      the remainder of the command string.
  3540.  
  3541.      Example:
  3542.  
  3543.           Wait 4
  3544.  
  3545.      Waits for 4 seconds
  3546.  
  3547.           Wait
  3548.  
  3549.      Asks user to press (Return) (A stdIO window must be open).
  3550.  
  3551. ---------------------------------------------------------------------
  3552.      Window
  3553.  
  3554.      Function: Selects a window, making it the source window.
  3555.  
  3556.      Syntax: Window<Path|DEST|NEXT>
  3557.  
  3558.      Arguments:
  3559.  
  3560.      path - An AmigaDOS path.  The window that matches the specified
  3561.      path will be selected.
  3562.  
  3563.      DEST - Selects the destination window.
  3564.  
  3565.      NEXT - Selects the window which appears as the nest window in the
  3566.      list.
  3567.  
  3568.      Example:
  3569.  
  3570.           Window DEST
  3571.  
  3572.      Selects destination window.
  3573.  
  3574.                                (Page 93)
  3575.  
  3576. 6.   INDEX
  3577.  
  3578. 8SVX 17,18,88
  3579. ACBM 18                         Color (cont)
  3580. Add                                Screen 6,40,74
  3581.    Arc 23                          Workbench 6,48
  3582.    Command 19,30,32,41,43       Comment 63,64
  3583.    Lharc 23                        File 7,16,36,46,86
  3584.    Menu Command 33,35           Configure 41,80
  3585.    Menu Item 19,33,34,38        Confirm 39,46,64
  3586.    Zoo 23                          Requester 21,25,28,31,39,45,
  3587. Assautocmd 57,58                   46
  3588. Addcmd 38,40,58                 Control
  3589. Addmenucmd 58,59                   Characters 57
  3590. ARC 1,19,23                        Menu 19,26
  3591. Archive 59,60                   Copy 65
  3592.    Bit 15,78                       Backup 4
  3593.    File 23                         Disk 5,25,26,27,67
  3594.    Menu 19,22,42,43                File 7,14
  3595.    Program 1,19,22,23              Hard Drive 4
  3596. ARexx 1,2,57,66,82,86,89           Multi 56
  3597. BarFormat 60                    Credits 5,6
  3598. Batch 43,60,61,83                  Window 21,28,29
  3599. Button 61                       Date
  3600.    Destination 5                   BarFormat 60
  3601.    Menu 3,35,43,48                 Current 7
  3602.    Mouse 2                         Display Format 36
  3603.    Parent 13                       File 7,14
  3604.    Select 2,4,49                   SetDate 85
  3605. Check 61,62                        SetFormat 86
  3606.    Size 18                      Delete 14,65,66
  3607. ChgCmd 62                          Bit 16
  3608.    Close                           Confirm 45
  3609.    Credits 6                       Move 14,72
  3610.    DiskMaster 21                   Protect 15,78
  3611.    Gadget 42,48,51              Deselect 66
  3612.    Requester 25,48,53,55,82        Clear 13
  3613.    StdIO 89                        Exclude 14
  3614.    Window 42,62,89                 UnMark 91
  3615. CloseWindow 62,63               Destination 5,7,8,9,13,14,18,22,
  3616. Color 63                           25,26,27,56,61,62,65,67,68,
  3617.    2.0 Pen 76                      71,72,73,92
  3618.    Command 30,31,40,58          Directory 12,13,16,68
  3619.    Directory 12                    Current 7,11
  3620.    File 12                         Display Format 35
  3621.    Palette 12,20,47,63             MakeDir 17,72
  3622.                                    Names 10
  3623.  
  3624.                                (Page 94)
  3625.  
  3626. Directory (cont)                Half 49,74,79,80
  3627.    NewDir 74                       Screen 48
  3628.    Root 10,11,12,13             Height 75
  3629.    Structure 9,10,11            Hex 17,18,49,77,79,80
  3630.    Sub 10,12                    IFF 17,18,58,88
  3631.    Swap 22                      ILBM 1,18,58,88
  3632. DirList 66,67                   Kickstart 1
  3633. Disk                            Lace 40,48,49,74,79,80
  3634.    Clear 25                     LHARC 1,19,23
  3635.    Copy 67                      List 8,11,15,23,31,33,35,39,57,
  3636.    Copy DF0: DF0: 25               66,75,78,86,92
  3637.    Copy DF0: DF1: 25               ARC 23
  3638.    Format 24,25,54,70              LHARC 23
  3639.    Menu 19,24                      ZOO 23
  3640. DiskCopy 5,24,25,26,56,59,67    Lock 22,26,71
  3641.    Requester 56,67              MakeDir 17,72
  3642. Draft 53                        Memory 56,67
  3643. Ed 31,32,33,35,41               Mouse 2,4,35,48,49,50,51
  3644. Elite 53                        Move 14,72,73
  3645. Error 55                        Msg 73
  3646. Execute                         NewDir 58,73,74
  3647.    AutoCommand 57               NLQ 53
  3648.    Bit 15,78                    OpenScreen 40,74
  3649.    Command String 30,39,45      OpenWindow 43,74,75
  3650.    Script 1,28,61               Page 49,52
  3651. Expand 68                          Down 50
  3652. External 31,32,35,41,68,69         Lines per 52
  3653.    Archive Program 59              Numbers 52
  3654.    Command 31                      Up 50
  3655.    Drive 5                      Palette 12,20,30,40,47,58,63,76
  3656.    Program 1,18                 Parent 13,61,75,76
  3657.    StdIO 89                     Pattern 13,14,16,17,46,57,58,66,
  3658. Extract 23                         69,70,81,82,84,84,87
  3659.    ARC 23                       Pens 76,77
  3660.    LHARC 23                        Light 4
  3661.    ZOO 23                       Pica 53
  3662. File display 7,8,9,11,12,15,    Play 17,18
  3663.    22,26,29,35,74,85,86         Print 18,20,77
  3664.    Lharc 23                        Setup 20,51
  3665. Find 16,69                      Priority 77,78
  3666. Fine 53                         Project
  3667. Font 70                            Add Command 30
  3668.    Change 21,37                    Add Menu Item 34
  3669.    Display 37                      Change Command 32
  3670. Format 24,25,36,54,55,70,71        Display Format 36
  3671.    Clear 25                        Files 4
  3672.    Display 19,35                   Menu 19,59
  3673.    Requester 54                    Quit 28
  3674.  
  3675.                                (Page 95)
  3676.  
  3677. Project (cont)                  Swap 22,90
  3678.    Save Command Window 42       Time
  3679.    Save Config 28,29,33,41         BarFormat 60
  3680. Protect 15,78,79                   Current 7
  3681. Bit 7,15,46,86                     Display Format 36
  3682. Bits 36,78                         File 7
  3683. Quit 21,28,38,39,45,46,79          SetDate 85
  3684. Read 17,38,43,48,49,50,51,79,80    SetFormat 86
  3685.    Bit 15                          Wait 92
  3686.    File Reader 48,79            TitleFormat 90
  3687.    Hexadecimal 17               Tools
  3688. Recursion 80,81                    Change Font 37
  3689. Rename 46,81                       Menu 19,21,43
  3690. ReqPattern 47,69,70,81,82,87       New Cmd Window 41
  3691. Reset 80                           Run DM Script 42
  3692. Rexx 82                         Unlock 27,91
  3693. Root 10,11,12,13,32,83          Unmark 91
  3694. Run 1,4,21,31,44,57,69          Wait 92
  3695.    DM Script 22,42              Width 75
  3696.    Selected 21                  Window 92
  3697. Save config                        Active 26,27
  3698. Menu 20                            Command 8,13,20,22,30,33,
  3699. Project 29,41                              35,38,41,42,44
  3700. SaveConfig 83                      Console 23 89
  3701. ScrBack 32,33,35,41,84             Credits 5,6,28,29
  3702. ScrFront 32,33,35,41,84            Destination 14
  3703. Select 12,13,84,85                 Distination 8
  3704.    Button 2,4                      Feedback 7
  3705. SetDate 85                         File Display 7,9,11,12,15,22,
  3706. SetFormat 85,86                                 26,35,37
  3707. SetList 86,87                      Lock 26,71
  3708. SetPattern 69,87                   Multiple Command 41
  3709. SetPrinter 87                      Multiple Destination 27
  3710. ShowPic 17,18,58,88                Multiple source 27
  3711. Single 88                          New 16,22
  3712. Sound                              Placement 29
  3713.    8SVX 17,18                      ScreenShare 2
  3714.    ShowPic 88                      Source 7,13,14,21,23,31,32
  3715. Source 5,7,8,9,13,14,17,18,21,     Swap 90
  3716.    22,23,25,26,27,31,32,33,35      Unlock 91
  3717.    56,59,61,64,65,66,67,        WorkBench
  3718.    68,69,71,72,73,75,76,77,        Color 6,12,20,48
  3719.    78,79,81,84,85,88,89,92      ZOO 1,19,23
  3720. Status 89
  3721.    Protection 16
  3722. StdIO 82,89,92
  3723.  
  3724.                   Thats it the FULL Doc's to DiskMaster
  3725.                                 Typed by
  3726.  
  3727.                              J.M.S.oftware
  3728.  
  3729.            * (713) 324-2139 * DANSE MACABRE * (713) 324-2139 *
  3730.  
  3731.